Unlock Real‑Time Insights: App Events Now Available in Admin UI Extensions & Embedded Apps

Shopify’s latest update lets Admin UI extensions and embedded apps emit app events directly from the admin, without tokens. Learn what changed, who it impacts, and how to start sending events today.

Unlock Real‑Time Insights: App Events Now Available in Admin UI Extensions & Embedded Apps
7 sections

Shopify developers and merchants can now capture granular usage data straight from the admin interface. The new shopify.appEvents.emit() API extends to Admin UI extensions and embedded apps, joining Checkout and Customer Account UI extensions in the App Events family. This means you can track how staff interact with your custom admin tools, enrich analytics, and power smarter decisions—all without handling access tokens or shop IDs.

What Changed

  • New surfaces for `shopify.appEvents.emit()` – The method is now supported in: 1. Admin UI extensions that use API version 2027‑01 or later (or are previewed with shopify app dev). 2. Embedded apps (App Home) that rely on Shopify App Bridge.
  • Event payload – You pass an event handle (a kebab‑case string) and an optional attributes object. Shopify automatically attaches the app and shop identifiers, so you don’t need to supply them.
  • shopify.appEvents.emit("description_generated", {

    word_count: 120,

    placement: "product_details"

    });

  • Rate limits – Each Admin UI extension can fire a burst of up to 20 events, then 2 events per second. Embedded apps share the same 2‑per‑second ceiling across all tabs in a single admin session.
  • Who Is Affected

  • Developers building Admin UI extensions on API 2027‑01+ or any embedded app that uses App Bridge can immediately start emitting events. No code changes are required for existing functionality, but you’ll want to add the new calls if you need usage data from the admin.
  • Merchants won’t see any UI change, but they’ll benefit from richer analytics in the app’s dashboard, helping them understand how staff are using custom admin features.
  • Legacy extensions built on earlier API versions won’t have access to shopify.appEvents. Upgrade the api_version in shopify.extension.toml to 2027-01 or later to unlock the feature.
  • How to Implement

  • Update your extension manifest – In shopify.extension.toml, set:
  • api_version = "2027-01"

  • Call `shopify.appEvents.emit()` wherever a meaningful interaction occurs (e.g., after a description generator finishes, after a bulk‑edit operation, etc.).
  • Handle the response – The method resolves to an object. Check success and log any error for debugging.
  • const result = await shopify.appEvents.emit("bulk_edit_complete", {

    records_updated: 45

    });

    if (!result.success) {

    console.error("App event failed:", result.error);

    }

  • Run locally – Use shopify app dev to preview the extension in a development store. The dev server injects the necessary runtime, so you can test events without deploying.
  • Verify in the Dev Dashboard – Open the App > Logs view. Successful events appear alongside backend‑sent events, confirming they were received.
  • Best Practices & Limits

  • Avoid PII – Never include names, emails, phone numbers, staff IDs, or customer IDs in the attributes object. Shopify will reject events that contain identifiable personal information.
  • Respect rate limits – Batch non‑critical events and send them after a user interaction finishes. If you need higher throughput, consider sending aggregated data from your backend instead of the frontend.
  • Billing events are separate – App Events emitted from the admin are not counted for Shopify App Pricing. If you need to report usage for billing, continue sending a billing event from your server‑side logic.
  • Testing & Verifying Events

  • Local dev – Run shopify app dev and interact with the extension in a dev store. Open the browser console to see the resolved object.
  • Production check – After deploying, navigate to the Dev Dashboard > Logs for your live app. Filter by event handle (e.g., description_generated) to confirm delivery.
  • Error handling – If emit returns {success:false, error:'Emit is unavailable.'} it means the current target (should‑render or data target) doesn’t support App Events, or the admin tab isn’t offering the feature. In that case, fall back to a backend call.
  • Next Steps for Merchants & Developers

  • Developers – Add a few strategic emit calls today, monitor the logs, and iterate. When you have a stable set of events, expose them in your app’s analytics UI so merchants can see adoption metrics.
  • Merchants – Ask your app developers to surface these new events in your admin reports. Knowing how often staff use custom tools can guide training and future feature requests.
  • Both sides – Keep an eye on the Shopify Dev Dashboard for any future limits or deprecations. The API is optional, so you can adopt at your own pace.
  • Conclusion & Call to Action

    The new shopify.appEvents.emit() for Admin UI extensions and embedded apps unlocks a powerful, token‑free way to capture in‑admin usage signals. By updating your shopify.extension.toml, sprinkling a few emit calls, and monitoring the Dev Dashboard, you’ll gain actionable insights without extra backend work. Start experimenting today, and let the data guide the next wave of custom admin experiences for your Shopify store.

    Tags
    Sources

    Related Articles

    Why Network Access Declarations Are Now Mandatory for Online Store Apps

    Why Network Access Declarations Are Now Mandatory for Online Store Apps

    Shopify now requires apps that run on the online store to declare their network access in shopify.app.toml. Learn what changed, who’s affected, and how to update your app before the December 2026 deadline.

    November 19, 20264 min
    Understanding the New applyResult Field in RolloutChange: What Developers Need to Know

    Understanding the New applyResult Field in RolloutChange: What Developers Need to Know

    Shopify’s GraphQL Admin API now returns an applyResult field on RolloutChange, letting apps track rollout outcomes in real time. Learn what changed, who it affects, and how to update your code to handle success, failure, and in‑progress states.

    November 19, 20264 min

    November 19, 20261 min
    Store Credit Now Powers Shopify Subscriptions with allowStoreCredit

    Store Credit Now Powers Shopify Subscriptions with allowStoreCredit

    Shopify’s 2027-01 API adds store‑credit support to subscriptions via the allowStoreCredit flag. Learn what changed, who’s impacted, and how developers can enable this new feature in minutes.

    November 19, 20265 min