Actions83
- Product Actions
- Product Variant Actions
- Collection Actions
- Article Actions
- Blog Actions
- Customer Actions
- Order Actions
- Draft Order Actions
- Inventory Actions
- File Actions
- Publication Actions
- Translation Actions
- Taxonomy Actions
- Metaobject Actions
- Metaobject Definition Actions
- Metafield Value Actions
- Metafield Definition Actions
- Service Actions
Translation → Get
AI-generatedSummary
Retrieve translations for an exact Shopify resource in a target locale, optionally scoped to a market. Use resource trees or field rows to inspect translation layers and identify missing translations.
Inputs
- authentication — Choose Admin API credentials (default) or OAuth2.
- resourceId (required) — Global Shopify ID of the exact translatable resource. For a metafield, use gid://shopify/Metafield/{id}.
- locale (required) — Target locale selected from the available options or supplied as an ID through an expression.
- marketId — Optional market selected from the available options or supplied as an ID through an expression.
- translationOptions.filterByOutdated — Enable filtering by translation outdated status. Defaults to false.
- translationOptions.outdated — When outdated filtering is enabled, choose outdated translations (true, default) or translations that are not outdated (false).
- translationOptions.includeMetafieldMetadata — Enrich metafield resources with namespace, key, definition name, and owner. Defaults to false.
- translationOptions.includeMetafields — Include nested metafields under the resource. Defaults to false.
- translationOptions.metafieldLimit — Limit nested metafields when included; defaults to 50, with a declared range of 1–250.
- translationOptions.outputShape — Choose Resource Tree (default), Field Rows (All), or Field Rows (Only Missing). Trees contain per-field source, translation layers, and nested metafields; rows expose source, translation layers, and effective value.
- outputMode — Choose Simplified (default), Raw, or Selected Fields output.
- selectedFields — Specify the fields to retain when Output Mode is Selected Fields.
Output shape
Translation data structured as a resource tree or a list of field rows, with raw and selected-field output modes also available.
Only Missing rows are declared to include fields missing a translation for the selected locale. Nested metafields and metafield metadata are optional. The source pack contains signatures only, so exact response keys, pagination behavior, and error envelopes cannot be confirmed.