Hi everyone,
I’ve been helping a few multilingual stores with their translations, and I found something that doesn’t match the docs.
The Help Center says:
“Filter labels, values, and groups can be translated into your store’s other supported languages.”
Labels, yes. Groups, I can’t find any way.
The setup: a product metafield filter (list.single_line_text_field) with manual value groups. For example, a group called “Negro” that combines BLACK, negro and Negro. On the storefront, “Negro” shows up untranslated in every language.
What I’ve tried:
- Translate & Adapt only shows the filter label. Group names don’t appear anywhere.
- I checked the API to see if it was just missing from the UI. The TranslatableResourceType enum only lists
FILTER with label as translatable. Nothing about groups.
translatableResources(resourceType: FILTER) only returns the filter label.
- The storefront uses IDs like
gid://shopify/FilterSettingGroup/177013115, but querying it returns “Invalid id” on both 2026-10 and unstable:
graphql
query {
translatableResource(resourceId: "gid://shopify/FilterSettingGroup/177013115") {
resourceId
translatableContent { key value }
}
}
My questions:
- Is there a supported way to translate manual group names that I’m missing? The merchant usually create this group names with custom strings inside “Search & Discovery”
- If not, is the Help Center wrong, or does it only refer to automatic groups on standard attributes?
- Any plans to expose filter groups in the Admin API, both to translate them and to read them (ID, name, values)?
For any store selling in more than one language, this means part of the filters stays in the original language, and there’s no clean fix today.
Thanks!
Hey @senabre
Your API results match the current public interface. Admin GraphQL provides the filter label through FILTER, but doesn’t expose a supported way to fetch manual group definitions or register translations for their names. Finding a group’s identifier on the storefront doesn’t change that availability.
The behavior in Translate & Adapt is a separate issue. Manually named groups are included in the expected translation support; it isn’t reserved for automatic taxonomy grouping.
For the missing groups in the app, please open a conversation with Shopify Support using an affected store. Share this forum URL and screenshots showing the group saved in Search & Discovery alongside that filter’s translation screen. Support can then check the store to understand why those names aren’t available in the editor.
On future public API access, I don’t have any confirmed plans to share.
Hey @Yoni-Shopify
thanks for confirming, really appreciate the clear answer!
I’d like to push on this a bit, though, because it’s bigger than one store. Opening a support ticket might fix Translate & Adapt for a single merchant, but it doesn’t solve the real problem. Today no translation app can read or translate manual filter groups, because the Admin API doesn’t expose them at all.
This is really unfair for the ecosystem, and it doesn’t make sense for a good GraphQL Translations API on Shopify…
Merchants create these groups all the time in Search & Discovery: “Men / Women”, “Leather / Textile”, color groups, and so on. They’re some of the most visible text on a collection page. So on every multilingual store that uses them, the filters stay in the original language, whatever translation solution the merchant picked
That goes against what the Help Center promises (“labels, values, and groups can be translated”), and against Shopify’s own push for Markets and selling internationally.
Exposing it shouldn’t be huge. It means a translatable resource for FilterSettingGroup (its name), plus read access to group definitions (ID, name, values). That would let the whole translation ecosystem support this properly instead of each merchant opening tickets one by one.
Could you please pass this on to the Translations API team?
Thanks!
Hey @senabre,
You’re right that resolving the missing fields in Translate & Adapt wouldn’t address the API limitation for third-party apps.
I’ve logged your request for public API access to read manual group definitions and translate their names. I included your examples to explain why merchants need these labels supported by their chosen translation app.
Thanks @Yoni-Shopify Hope they can ship this soon…