Registering Translation App Intent

Shopify App Store
1

Today, when a merchant clicks Translate at Settings > Languages, Admin lists every app holding the write_translations scope. That includes many apps not built for translation, which clutters the experience.

Shopify is moving the Translate flows to an app intent. After the change, the associated dropdown lists will show only apps that have registered the translation intent; so dedicated translation apps are easy to find, and unrelated apps drop off. Through this intent, there will also be new entry points for translation apps to appear in.

Here are the surfaces that apps with registered intent will appear in:

  1. Content > Menu details
  2. Content > Metaobject details
  3. Markets > web-presence languages table
  4. Notifications > template editor
  5. Notifications > template preview
  6. Customer privacy > cookie banner card
  7. Settings > Languages
  8. Settings > Legal
  9. Shipping > packing slip template
  10. Online Store Surfaces
  11. Preferences > Home page title + Meta description label actions
  12. Themes > Languages page (Edit default theme content)
  13. Editor > localization exception banner
  14. Editor > template-restriction banner link
  15. Editor > section + block overflow menus

How to register the intent in your app’s shopify.extension.toml:

[[extensions]]
name = "Translate"
description = "Translate and adapt store content into another language."
handle = "translate-intent"
type = "admin_link"

[[extensions.targeting]]
target = "admin.app.intent.link"
url = "/"

[[extensions.targeting.intents]]
type = "shopify/content-localization"
action = "edit"
schema = "./localization.intent.json"

Add a localization.intent.json that maps the incoming locale (an ISO code like fr) into your app’s URL as shopLocale. Your launch URL is unchanged, Admin still appends ?shopLocale=fr to your existing entry point. The intent adds two things: the store’s GID as the intent subject, and a completion signal back to Admin.

After January 1, 2027, apps that haven’t registered the intent will no longer appear in Settings > Languages in Admin. The changes to enable app intent will be released in unstable on September 11, 2026, so you can register early and test it.

2 Likes