A client sends a screenshot from the Instagram app: their latest Reel shows far more views than the number in your monthly report. They want to know which one is wrong. Usually neither is. The app and most reports are counting different things, and since April 2026 Meta has offered an API metric, total_views, built to match what the app shows. Agencies that crosspost client Reels to Facebook or boost Instagram posts see the biggest gaps, and they are the ones who need a clear answer before the next report goes out.
This guide explains what Instagram total views counts, why the standard views figure is lower, which metric needs which login type, and how to present both numbers so clients stop comparing screenshots.
Key takeaways
Instagram total views is the total_views media metric, which counts every time a post was seen across all surfaces, including Facebook and promoted, boosted or ad versions of the post. Meta added it to the API on 22 April 2026, alongside total_likes and total_comments, according to the Instagram Platform changelog. The same entry says these values "match what users see in the Instagram Insights Dashboard", and each one is also available as a field on the media object (total_views_count, total_likes_count and total_comments_count).
This closed a gap Meta acknowledged in December 2025, when it noted that Reels crossposted to Facebook show aggregated views in the Instagram app while the API returned Instagram-only numbers. Its first fix then was two narrower metrics, crossposted_views and facebook_views. total_views is the broader version that also takes in paid distribution.
One detail to test on your own accounts: the April changelog describes total_views as covering video media only, while the media insights reference lists it for Feed posts, Reels and Stories. Meta has not reconciled the two pages.
Your report shows fewer views because most reports read the views metric, which counts plays on Instagram only and excludes ads, while the app can include Facebook plays and paid plays. The media insights reference defines views as the number of times the media "has been played on Instagram", and its limitations section says that comments, likes, views and total_interactions report organic interactions only. Interactions on ads containing the post are not counted.
So the gap between the app and the report is usually made of two parts:
Timing and coverage can widen it further. Meta says insights can be delayed by up to 48 hours, so a report run on the 1st may miss the last day or two of the month. Media inside a carousel album has no insights at all. Unavailable data comes back as an empty set rather than zero, which a careless dashboard can show as a blank or quietly drop. And Meta flags views itself as a "metric in development", so definitions may still shift.
The four Instagram views metrics differ in where the play happened and whether paid distribution counts: views is Instagram only, facebook_views is Facebook only, crossposted_views combines both for Reels, and total_views adds promoted media on top. Here is how the media insights reference describes each one.
| Metric | What it counts | Media types | Note |
|---|---|---|---|
| views | Plays on Instagram, organic only | Feed, Reels, Stories | Marked as in development |
| facebook_views | Plays on Facebook | Feed, Reels, Stories | Errors if not shared to Facebook |
| crossposted_views | Plays across Instagram and Facebook | Reels | Errors if not shared to Facebook |
| total_views | Views across all surfaces, including promoted media | Feed, Reels, Stories in the reference | Facebook Login only |
Two practical consequences follow. First, facebook_views and crossposted_views return an error, not zero, for posts that were never shared to Facebook, so a report has to request them per post and handle the error. Second, reach is a separate idea: Meta describes reach as the number of unique Instagram users who saw the media, and calls it an estimate. Do not add reach to any of the views figures or compare them as if they were the same unit.
You need the Instagram API with Facebook Login to request Instagram total views, total_likes or total_comments; apps using Instagram Login cannot get them. The reference lists different permissions for each route. Facebook Login (graph.facebook.com) needs instagram_basic, instagram_manage_insights and pages_read_engagement, plus ads_management and ads_read for users whose Page role comes through Business Manager. Instagram Login (graph.instagram.com) needs instagram_business_basic and instagram_business_manage_insights.
The login type gates other recent additions too. The reposts_count, saved_count and shares_count fields added in April are for Facebook Login apps, and the Story link_clicks metric added on 22 June 2026, which counts taps on links such as link stickers, is also Facebook Login only. If a tool connects Instagram on its own without a linked Facebook Page, ask which login it uses before you promise a client these figures.
Lead with organic Instagram views as the content performance metric, and show Instagram total views only as a clearly labelled second figure when the client crossposts or boosts. Organic views tell you whether the content itself is working on Instagram. The all-surfaces total mixes in Facebook distribution and paid spend, which belong to other parts of the report.
For reference, AgencyReportr connects Instagram through Facebook Login, using the Instagram business account linked to the client's Facebook Page, and for each post it reads Instagram's views metric alongside reach, saves and shares. That keeps the organic figure clean, which is why it can sit below the app's number on a crossposted or boosted Reel. Our social media reporting tool places Instagram next to Facebook, where Meta's switch from Facebook reach changed the numbers in a similar way.
Explain the gap as two honest numbers measuring different things: organic Instagram views in the report, and a total in the app that also counts Facebook and paid plays. Clients accept a difference they were told about. They lose trust when they find it themselves.
Wording you can reuse: "The Instagram app shows total views, which includes plays on Facebook when a Reel is shared there, and plays from boosted posts. Our report shows organic views on Instagram, so we can judge the content on its own. Paid results are in the ads section of this report."
Put a short version of that note under the Instagram chart in every report, with the same wording for every client. In white-label client reports it goes out under your brand, so the explanation reads as your expertise rather than a correction.
AgencyReportr pulls Instagram views, reach, engagement and top posts into a branded client report with Facebook and YouTube alongside, and sends it on your schedule. Start with a $1 trial.
7-day trial · Cancel any time
total_views is an Instagram media metric Meta added on 22 April 2026. It counts the times a post was seen across all surfaces, including Facebook and promoted, boosted or ad versions, and Meta says it matches the Instagram Insights dashboard.
Most reports read the views metric, which counts plays on Instagram and organic interactions only. The app's figure can also include plays on Facebook for crossposted content and plays from boosted posts and ads, so it is usually higher.
No. Meta's reference says total_views, total_likes and total_comments are only available through the Instagram API with Facebook Login. Tools that connect through Instagram Login cannot request them.
crossposted_views counts plays of a Reel across Instagram and Facebook combined. facebook_views counts plays on Facebook only and covers Feed posts, Reels and Stories. Both return an error if the media was not shared to Facebook.
Meta says media metrics are stored for up to 2 years and can be delayed by up to 48 hours. Story metrics are only available for 24 hours, so export a monthly snapshot if clients need longer history.
Connect SEO, Google Ads, Meta Ads, Amazon Ads and more, and send a branded client report on schedule.
Cancel anytime · Setup in minutes