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

    Draft Orders Now Require the Apply Discounts Permission – What Developers Need to Know

    Draft Orders Now Require the Apply Discounts Permission – What Developers Need to Know

    Shopify’s latest API change blocks draftOrderCreate and draftOrderUpdate from adding discounts unless the staff member has the apply_discounts_to_draft_orders permission. Learn what changed, who’s impacted, and how to update your app today.

    November 18, 20264 min
    Admin‑Created Custom Apps Now Live in the Shopify Dev Dashboard

    Admin‑Created Custom Apps Now Live in the Shopify Dev Dashboard

    Shopify now surfaces custom apps built in the admin inside the Dev Dashboard, giving developers centralized credential control, IP allowlisting, and full API/webhook logs. Learn what changed, who’s affected, and how to secure and monitor your apps today.

    November 17, 20265 min
    Custom Apps From the Admin Now Live in the Dev Dashboard – What You Need to Know

    Custom Apps From the Admin Now Live in the Dev Dashboard – What You Need to Know

    Legacy custom apps created in the Shopify admin are now visible in the Dev Dashboard, giving merchants and developers richer security controls, IP restrictions, and activity logs. Learn what changed, who’s impacted, and how to migrate your apps today.

    November 17, 20265 min
    Amazon EventBridge Webhook Payloads Now Up to 1 MB – What It Means for Your Shopify Apps

    Amazon EventBridge Webhook Payloads Now Up to 1 MB – What It Means for Your Shopify Apps

    Shopify increased the Amazon EventBridge webhook payload limit from 256 KB to 1 MB, letting developers receive larger product and order data inline. Learn who is affected, how it works, and what steps to take now.

    November 17, 20265 min