Are theme_name and theme_version guaranteed to be unique across Shopify themes?

I’m building an app feature that needs to resolve theme-specific configuration based on a theme’s theme_name and theme_version (read from settings_schema.json).

Before relying on these values as identifiers, I’d like to clarify:

  • Are theme_name and theme_version guaranteed to be unique?

  • When submitting a theme to the Shopify Theme Store, are authors required to use a unique theme name that doesn’t already exist in the store?

  • Can third-party or custom themes (for example, from ThemeForest) use the same theme_name (e.g. “Dawn”) and similar theme_version values?

  • In general, does Shopify enforce any uniqueness or validation rules on these fields?

I want to understand whether these values are safe to use as identifiers, or if they should only be treated as best-effort metadata.

Thanks!

Regardless of enforcement in the theme itself, this is exposed in the theme code and can be edited by any merchant/use so I would definitely consider it more of a best effort.

2 Likes

Thanks so much. :slightly_smiling_face: I had the solution.