← NotesTR
5 min read

Shopify Embedded Apps: Do You Need App Bridge?

Should your Shopify app open inside admin? A decision framework for embedded apps, App Bridge, and Polaris for merchants, agencies, and developers.

  • shopify
  • app-bridge
  • embedded-admin
  • development
  • polaris

When a store owner installs an app, they experience one of two things: a seamless embedded app inside Shopify admin, or a standalone app that feels like being redirected to another site. On the developer side, this distinction directly affects App Bridge, OAuth, and UI consistency decisions.

Who is this for?

Store owner: If you expect apps to work without leaving admin, embedded experience is a quality signal when choosing from the App Store.

Agency / technical consultant: Planning a custom app or integration for a client; you need to evaluate whether admin experience meets Shopify standards.

App developer or founder: Public app or custom app; standalone or embedded — the architecture decision must come early.

The decision problem: Is your app's primary use case inside Shopify admin, or on your own domain as an independent panel?

The concrete problem: when embedded makes sense

Embedded apps generally make sense when:

  • Store owner will use Resource Picker to select products, collections, or orders
  • Settings and daily operations happen inside admin
  • You are launching a public App Store app (Shopify expects embedded experience)
  • You want secure, cookie-independent auth via OAuth and session tokens

Standalone apps on your own domain may be preferable when:

  • B2B portal, external dashboard, or multi-page complex UI does not fit an admin iframe
  • User base is not only Shopify admin (e.g. logistics operator)
  • Your existing SaaS product has its own UI; Shopify integration is a side channel

"Is App Bridge required?" really means "Will the user stay in admin context?"

Decision framework and checklist

User experience

  • Store owner opens the app dozens of times daily in admin → prefer embedded
  • App is a once-a-month setup or migration tool → standalone acceptable
  • Product/collection selection is frequent → Resource Picker (App Bridge) is a major convenience

App Store and policy

  • Targeting public App Store listing → embedded + consistent UX (Polaris recommended)
  • Custom app for one store only → embedded not required, but admin integration still valuable

Technical capacity

  • Session token validation possible on backend → ready for embedded
  • Local development tunnel (Shopify CLI, ngrok, etc.) can be set up
  • App Bridge version (currently App Remix / App Bridge 4.x line) can be maintained

Security

  • Avoid third-party cookie restrictions → session token path
  • Short-lived token refresh on every API call → App Bridge handles this

Polaris UI

  • Visual consistency with admin matters → Polaris components (Page, Card, DataTable)
  • Fully custom branded UI required → standalone or hybrid; may need extra explanation in review

Summary: Daily operations tool + App Store → embedded App Bridge. External portal or rare use → evaluate standalone.

Development setup: if you choose embedded

Once you decide embedded, technical preparation follows:

  1. Shopify Partner account and development store
  2. Mark the app as embedded
  3. App Bridge and (preferably) Polaris dependencies
  4. Local development with Shopify CLI (shopify app dev)
  5. Session token validation layer on backend

Without a tunnel in local development (ngrok, Cloudflare Tunnel, or CLI proxy), the admin iframe cannot reach your app. Skipping this step leads to "works locally, broken in production."

As a store owner evaluating embedded apps, check after installation whether the app opens from admin and whether product selection screens feel native. You do not need technical details; experience quality is a valid selection criterion.

If targeting a public app, App Store review also covers consistent navigation, clear error messages, and OAuth permission explanations as part of your embedded decision. Disconnecting admin experience into a standalone panel is a common review feedback topic.

Common mistakes

Marking embedded but building like standalone. If the app opens outside the iframe, store owners get a disjointed experience; App Store review may flag it.

Making API calls without validating session tokens. Cookie-based auth is unreliable in modern browsers; backend must validate every request.

Inconsistent UI without Polaris. Not mandatory, but UI that looks disconnected from admin increases support tickets and review friction.

Manual ID entry instead of Resource Picker. Operational burden for store owners; wastes the main advantage of embedded apps.

Not updating App Bridge version. Old versions may work, but current Shopify app templates (App Remix) reduce startup cost for new apps.

Frequently asked questions

Can you publish a Shopify app without App Bridge?

Technically, standalone apps are possible. For public App Store apps, embedded experience is effectively the standard; plan App Bridge if admin use is your target.

Is Polaris mandatory?

No, but strongly recommended for visual alignment with Shopify admin and review process. If using custom UI, test accessibility and navigation consistency carefully.

Is embedded required for custom apps?

No. Standalone panels are common for single-store custom apps. If the store owner will configure settings without leaving admin, embedded is still a good choice.

Why are session tokens short-lived?

Security. Tokens are valid for roughly one minute; App Bridge manages refresh. Backend should expect a fresh token on every API request; build a validation layer instead of storing long-lived tokens.

Next step

Embedded app vs standalone directly determines project UX and cost. To clarify architecture, send a brief requirements summary to info@murattanriover.com.tr — we can evaluate whether admin-embedded or external panel fits better.