What is the best practice for dynamically detecting if an App Block / App Embed is active on the main theme?

GraphQL Admin API Troubleshooting
1

Hi everyone,

What is the officially recommended, modern approach to programmatically verify if a specific App Block or App Embed is successfully added and enabled in a merchant’s active main theme?

I am looking for the best practice to detect this status reliably. Specifically:

  1. Official Endpoints: Is there a dedicated API endpoint or GraphQL query that directly returns the activation status of a theme app extension?

  2. Environment UUIDs: Because the UUID associated with an extension can change between development, staging, and production, how should the detection logic handle this dynamically without relying on hardcoded IDs?

  3. Performance: What are the rate-limiting considerations or caching best practices to keep in mind when this status needs to be checked frequently?

Any insights, documentation links, or production-tested patterns would be hugely appreciated!

Thanks in advance.

2

Please do have a good read of the documentation next time:

3

Thanks @Luke for providing this doc link.