Translate custom pages by API

Topic summary

Main issue: How to translate a custom online store page via API, preferably using GraphQL, with no clear examples available.

Key guidance: Shopify support points to the official translation guide for translating resources via API using the Admin GraphQL API. For custom pages, the relevant translatable resource type is ONLINE_STORE_PAGE (i.e., standard Online Store pages).

Context/terms: “Translatable resource” refers to content types that support localization via the API. The Admin GraphQL API provides mutations/queries to manage translations for these resources.

Outcomes: Concrete direction provided (use the official guide and target ONLINE_STORE_PAGE for custom pages). No code samples shared in-thread; links guide the implementation.

Status: Likely actionable with the provided docs; no confirmation of implementation success yet, so resolution remains pending.

Summarized with AI on January 3. AI used: gpt-5.

Hello,

How could you translate a custom page via API? I found out that GraphQL API could help me, but I can’t find any example on the whole web.

Any idea?

Thanks!

Hey @Jancso !

We have a guide here that goes through the process of translating resources via API. https://shopify.dev/docs/apps/selling-strategies/markets/translate-content

Since you’re looking to translate a custom page, the translatable resource you’ll need is the ONLINE_STORE_PAGE https://shopify.dev/docs/api/admin-graphql/2024-01/enums/TranslatableResourceType#value-onlinestorepage

Hope that helps,

Kyle G.