Locales

O que é traduzido

Campos de texto e prose guardam um valor por locale onde quer que estejam: no topo de um registro, dentro de um modelo inline, em um item de lista ou em um modelo colocado em um campo prose. Todo outro tipo de campo, incluindo números, datas, referências e mídia, tem um único valor compartilhado por todos os locales. O texto alternativo de imagem faz parte do valor da imagem, então também é compartilhado.

Configurando locales

Os locales são códigos BCP-47 configurados por projeto. Um deles é o padrão, o idioma em que você escreve, e cada um pode indicar um locale de fallback. Um fallback que indica um locale que o projeto não tem, aponta para si mesmo ou fecha um ciclo é recusado ao salvar.

As traduções são escritas no editor de registros do console ou por um agente de IA via MCP. A API GraphQL e o SDK leem as traduções e não as escrevem.

A cadeia de fallback

Passe locale em uma leitura e cada campo é resolvido separadamente, nesta ordem: o locale que você pediu, seus fallbacks configurados em sequência, os locales mais próximos do projeto no mesmo idioma escrito, o padrão do projeto e, por fim, o valor de autoria. O primeiro que tiver valor é servido, então um registro parcialmente traduzido pode retornar o título de um locale e o corpo de outro.

A etapa de correspondência mais próxima fica dentro de um padrão escrito: um pedido de pt-PT só recebe o conteúdo de pt-BR se você definir esse fallback por conta própria. Um locale que o projeto não configurou ainda assim retorna conteúdo, terminando no padrão.

Encontrando as lacunas

Defina localeStrict em uma leitura e a resposta lista os campos que não tinham tradução e informa um locale não configurado como erro. resolutionTrace retorna o percurso completo e exige uma chave com o escopo de debug de segmentação. Nenhum dos dois altera o conteúdo servido.