--- title: Full-stack capabilities to power app analytics - Shopify developer changelog description: >- Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities. source_url: html: 'https://shopify.dev/changelog/full-stack-capabilities-to-power-app-analytics' md: >- https://shopify.dev/changelog/full-stack-capabilities-to-power-app-analytics.md metadata: effectiveApiVersion: 2026-10 affectedApi: - displayName: Admin GraphQL API handle: admin-graphql - displayName: App Events API handle: app-events-api - displayName: Metafields and metaobjects handle: metafields-metaobjects - displayName: ShopifyQL handle: shopifyql primaryTag: displayName: API handle: api secondaryTag: displayName: New handle: new indicatesActionRequired: false createdAt: '2026-07-16T13:28:51-04:00' postedAt: '2026-07-21T09:00:00-04:00' updatedAt: '2026-07-21T09:14:22-04:00' effectiveAt: '2026-07-21T09:30:00-04:00' --- # Full-stack capabilities to power app analytics Shopify Analytics is now a full-stack platform for apps. Model, query, embed, and enrich analytics on Shopify without managing your own data infrastructure. [Sign up for early access](https://forms.gle/teCRjZK1AKPjzrgF9) [Sign up to get access when the preview opens](https://forms.gle/teCRjZK1AKPjzrgF9) DateJuly 21, 2026 Version[2026-10](https://shopify.dev/changelog?api_version=2026-10) FlagsNew SurfacesAPI Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)[App Events API](https://shopify.dev/changelog?api_type=app-events-api)[Metafields and metaobjects](https://shopify.dev/changelog?api_type=metafields-metaobjects)[ShopifyQL](https://shopify.dev/changelog?api_type=shopifyql) For app developers, building merchant-facing analytics has always meant standing up your own stack: a charting library, a data warehouse to sync merchant data into, handling currencies and locales, and a UI that never quite matched the Shopify admin. With these updates, Shopify Analytics becomes a full-stack analytics platform that apps can build on directly, offloading the infrastructure to Shopify and putting your app's data where merchants already make decisions. Here's what shipped, and how it fits together. ## Bring your app's data into Shopify Analytics ### Metafields Mark a metafield definition as analytics-queryable, and it becomes a dimension in ShopifyQL alongside store data. Add, for example, a `campaign_source` metafield to an order or a `subscription_status` metafield to a customer. Merchants can group, filter, and chart on it—no ETL, no separate schema. ```sql FROM sales SHOW total_sales GROUP BY order.metafields.my_app.campaign_source TIMESERIES day VISUALIZE total_sales ``` ### App Events (early access) App Events in Analytics makes the custom events your app already emits queryable in Shopify Analytics. Declare events from the new registry in `shopify.app.toml`, emit them through the App Events API, and merchants can query `FROM app_events` in ShopifyQL the same way they query their store data. ```sql FROM app_events SHOW emails_sent GROUP BY app_name TIMESERIES day VISUALIZE total_sales ``` ## Query it: Shopify​QL API + dev docs The ShopifyQL API, Shopify's analytics query layer, is now a first-class part of the platform, with schema-level reference documentation on shopify.dev. Every metric and dimension is defined in the docs with its type, description, and working examples. **Why it matters:** * For developers: Build against a stable, versioned, schema-documented surface. * For LLMs and agents: Public schema docs mean AI toolchains can generate working ShopifyQL. ## Embed it: Analytics Web Components The same web components that render analytics in the Shopify admin— the metric card (``), the metrics bar (``), and its date picker (``)—are now available for third-party apps to embed. Render a chart with a single element: ```html ``` Load `analytics-ui.js` (after `polaris.js`), enable Direct API access, then drop in the element. No charting library. No currency or locale handling. No data-formatting code. The component runs the query, renders the chart, and stays in sync with the Shopify admin. ## Enrich it: Annotations API + Metric Targets API Two new APIs let apps and merchants add context on top of the numbers. ### Annotations API Partner apps can now create annotations directly on merchant charts through the GraphQL Admin API. Loyalty apps can mark the day a program launched; email apps can mark a new campaign; subscription apps can mark a pricing change—with proper app attribution rendered in the chart panel. Required scopes: `read_analytics_annotations`, `write_analytics_annotations`. ### Metric Targets API Merchants can now set targets on any metric—total sales next quarter, ad-attributed revenue this week—and track progress visually inside reports and dashboards. Targets are a new core primitive in the GraphQL Admin API, so apps can create, read, and overlay them on charts programmatically. ### How it fits together 1. Model your data with Metafields (and App Events, in early access). 2. Query with the ShopifyQL API. 3. Embed with Analytics Web Components. 4. Enrich with Annotations and Metric Targets. All inside Shopify, where merchants already make decisions. ## Get started * [Analytics for Developers](https://shopify.dev/docs/apps/build/analytics) * [Metafields](https://shopify.dev/docs/apps/build/metafields/use-metafield-capabilities#analytics-queryable) * App Events in Analytics — [Sign up for early access](https://forms.gle/teCRjZK1AKPjzrgF9) * [ShopifyQL API](https://shopify.dev/docs/api/shopifyql) * [Web Components](https://shopify.dev/docs/api/shopifyql/latest/web-components) * [Annotations API](https://shopify.dev/docs/api/admin-graphql/2026-10/mutations/analyticsAnnotationCreate) * [Metric Targets API](https://shopify.dev/docs/api/admin-graphql/unstable/input-objects/AnalyticsTargetCreateInput)