my app is not listed on the app embedd screen i have the access to read and write themes and online

Shopify Discussion
, , , ,

Topic summary

A developer’s Shopify app isn’t appearing in the App Embed screen (Online Store > Themes > Customize) despite having proper theme read/write permissions and creating the required app block.

Key troubleshooting steps suggested:

  • Verify shopify.app.toml includes proper app_embed configuration with correct type and name
  • Confirm shopify.extension.toml specifies type = "theme_app_extension"
  • Check schema.json formatting in the app block directory
  • Manually enable the App Embed toggle in Theme Customizer (may not auto-enable)
  • Deploy the extension using shopify app deploy command
  • Clear theme cache or test on a duplicated theme

Additional recommendations:

  • Uninstall/reinstall the app to reset settings
  • Verify app isn’t in draft mode in Partner Dashboard

The discussion remains open pending confirmation whether these solutions resolved the issue.

Summarized with AI on November 1. AI used: claude-sonnet-4-5-20250929.
1

Hi all,

I’ve developed a Shopify app that requires embedding a JavaScript code snippet into the store’s theme using the app block. I have access to read and write both the themes and the online store, but my app isn’t showing up in the “App Embed” screen under Online Store > Themes > Customize.

Here are some details:

  • My app has the correct access scopes for reading and modifying themes.
  • I’ve created the required app block, which should allow the script injection.
  • Everything else with the app seems to be functioning as expected.

Is there a step I might be missing, or do I need to adjust any specific settings for the app to appear in the app embed screen?

Any insights would be greatly appreciated!

2

Hi @The-Backend-Eng

It sounds like you’ve set up your Shopify app correctly with the necessary permissions and theme access, but it’s not appearing under Online Store > Themes > Customize > App Embed. There are a few key things to check that might be causing this issue.

**Possible Reasons & Fixes:**1. #### Check the shopify.app.toml Configuration

Ensure that your app is properly configured to include an App Embed section. In your shopify.app.toml file (or if you’re using the Shopify CLI), you should have something like this:

[[ui_extensions]]

type = “app_embed”

name = “MyAppEmbed”

  1. Verify the Extension Type in shopify.extension.toml

If your app is using an App Embed block, make sure your shopify.extension.toml file specifies the correct type:

type = “theme_app_extension”

name = “My App Embed”

  • If it’s missing, Shopify won’t recognize your app in the Customize > App Embed section.

  1. Check Your schema.json in the App Block Directory

Inside your app extension directory (extensions/my-app/blocks/app-embed/), ensure your schema.json is correctly formatted:
json
CopyEdit
{

“name”: “My App Embed”,

“target”: “section”,

“settings”:

}

  1. Enable the App Embed in Your Theme Customizer

  • Even if everything is set up correctly, sometimes Shopify doesn’t automatically enable the App Embed.
  • Go to Online Store > Themes > Customize > App Embed and toggle it ON manually.1. #### Check for Pending Updates
  • If you recently updated your app but didn’t deploy the extension, Shopify might not register it.

Run this command in your terminal to ensure it’s deployed:

shopify app deploy

  1. Clear Theme Cache and Update the Store
  • Sometimes, Shopify caches theme settings and doesn’t update immediately. Try refreshing the page or clearing your browser cache.
  • If the issue persists, try duplicating the theme and testing on a fresh copy.

Final Thoughts

If none of these steps resolve the issue, try uninstalling and reinstalling the app to reset its settings in Shopify. Also, double-check that your app is not in draft mode and that it’s correctly registered in the Shopify Partner Dashboard.

If you need any other assistance, feel free to reply and I will try my best to help.
Best regards,
Daisy