---
title: >-
  Updates required for embedded apps to work on the new Shopify admin domain -
  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/updates-required-for-embedded-apps-to-work-on-the-new-shopify-admin-domain
  md: >-
    https://shopify.dev/changelog/updates-required-for-embedded-apps-to-work-on-the-new-shopify-admin-domain.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: true
  createdAt: '2022-09-16T12:04:00-04:00'
  postedAt: '2022-09-16T00:00:00-04:00'
  updatedAt: '2024-02-02T10:57:42-05:00'
  effectiveAt: '2022-09-16T00:00:00-04:00'
---

September 16, 2022

Tags:

* Action Required
* API

# Updates required for embedded apps to work on the new Shopify admin domain

The Shopify admin is moving to a new domain: `admin.shopify.com`. Embedded apps should migrate to [App Bridge 3.0](https://shopify.dev/apps/tools/app-bridge/migrating-to-3) as soon as possible to ensure the best merchant experience in this new domain.

The following requirements must be met for embedded apps to load in `admin.shopify.com`. Until these requirements are met, merchants will be forced to redirect to the old admin domain to use the app:

1. The [content security policy](https://shopify.dev/apps/store/security/iframe-protection) includes `admin.shopify.com`.
2. The app is on [App Bridge 2.0.5 or higher](https://shopify.dev/apps/tools/app-bridge/updating-overview#ensure-compatibility-with-the-new-shopify-admin-domain), and has correctly implemented the [`host`](https://shopify.dev/apps/tools/app-bridge/retrieve-the-host) parameter. [App Bridge 3.0](https://shopify.dev/apps/tools/app-bridge/migrating-to-3) is recommended.