# General Translation Knowledge Base: ¿Cómo traduzco contenido en Sanity? URL: https://generaltranslation.com/es/kb/translate-sanity-content.mdx Docs index: https://generaltranslation.com/llms.txt Description: Almacena cada idioma como un documento propio o como un valor por configuración regional en cada campo y, después, traduce el origen a cada configuración regional de destino. El plugin gt-sanity de General Translation añade una acción Translate a Sanity Studio y, de forma predeterminada, importa cada traducción como un borrador para que lo revises y lo publiques. Category: Herramientas para flujos de trabajo Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Para traducir contenido en Sanity, se almacena cada idioma como un documento independiente identificado mediante un campo de idioma (localización a nivel de documento) o como un valor por configuración regional dentro de cada campo (localización a nivel de campo) y, después, se completa cada idioma de destino a partir del origen. Es complicado porque un documento contiene datos estructurados: Portable Text (el formato de texto enriquecido de Sanity) debe conservar sus bloques y marcas; las imágenes, fechas y números deben copiarse tal cual; si hay un documento por idioma, cada referencia debe apuntar a la traducción correspondiente, y las correcciones que hagan los editores en las traducciones no deben perderse con la siguiente actualización. ## Video The video is narrated in English, with English captions. [How do I translate content in Sanity?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-translate-sanity-content.mp4) (47 s) General Translation lets you click Translate on a Sanity document with the `gt-sanity` plugin. Add `gtPlugin` to `sanity.config.ts` with your locales and document types, give the article a language field, store your API key in a private document, publish the drafts the plugin imports, and query each language by its language field. ## Formas de traducir contenido de Sanity | Enfoque | En qué destaca | Cómo llegan las traducciones a Sanity | Qué queda a tu cargo | | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Solo los plugins de localización de Sanity | Almacenan cada idioma como un documento independiente o como un valor por configuración regional en cada campo | Tus editores o traductores escriben cada idioma en Sanity Studio | Cada traducción y cada actualización cuando cambia el origen | | Google Translate | Traduce el texto que pegas, sin configuración inicial | Copiar y pegar, o un script que escribe a través de la API de Sanity | Traduce cada cadena por separado; dividir Portable Text en cadenas y reconstruirlo, copiar los demás campos, redirigir las referencias, mantener la coherencia terminológica y revisar corren por tu cuenta | | Un script sobre una API de IA (OpenAI API, Claude API) | Traduce muchos documentos en una sola ejecución automatizada, con tu tono y tu terminología en el prompt | Un script que escribe a través de la API de Sanity | Dividir y reconstruir Portable Text, copiar los demás campos, redirigir las referencias, aportar el contexto y la terminología en cada solicitud, y revisar | | General Translation (`gt-sanity`) | Traduce texto y Portable Text con los grupos de contexto (glosario y prompts personalizados) de tu proyecto | Una acción **Translate** en Studio importa cada configuración regional como borrador | Un campo de idioma, un documento de credenciales y una revisión antes de publicar | Usa solo los plugins de localización de Sanity cuando los traductores escriben cada idioma y el contenido apenas cambia; usa Google Translate o un script con una API de IA para textos puntuales que alguien revisa antes de publicarlos. Usa General Translation cuando los documentos incluyen texto enriquecido y referencias, y cambian con frecuencia. ## Traducir documentos con gt-sanity El plugin `gt-sanity` de General Translation añade una acción **Translate** a Sanity Studio y es compatible con ambos modelos; el nivel de documento es el valor predeterminado de `translationLevel`. 1. Instálalo con `npm install gt-sanity`. 2. Añade un campo `language` a cada tipo de documento que quieras traducir. 3. Guarda el ID del proyecto y la clave de API del proyecto en un documento privado `generaltranslation.secrets`. 4. Añade `gtPlugin` a `sanity.config.ts` con tus configuraciones regionales y tipos de documento: ```ts title="sanity.config.ts" import { defineConfig } from 'sanity'; import { gtPlugin } from 'gt-sanity'; export default defineConfig({ // ... tu configuración existente plugins: [ gtPlugin({ sourceLocale: 'en', locales: ['es', 'zh', 'ja'], translateDocuments: [{ type: 'article' }, { type: 'page' }], }), ], }); ``` 5. Haz clic en **Translate** en un documento de origen. ## Qué hace una ejecución de traducción En la configuración predeterminada a nivel de documento, **Translate** envía a traducir el texto y el Portable Text del documento, deja intactas las imágenes, fechas, números y referencias, e importa cada configuración regional como borrador. La publicación automática, la aplicación de parches a referencias (que redirige cada referencia a la traducción de la misma configuración regional) y **Save local edits** (que conserva los cambios de los editores cuando el texto de origen no ha cambiado) están desactivadas de forma predeterminada. Tu frontend consulta cada idioma con un filtro GROQ como `language == "es"`. Si tu aplicación también usa General Translation, asigna el mismo grupo de contexto a ambos proyectos para que los términos se traduzcan de forma coherente. En el [Inicio rápido de Sanity](/docs/integrations/sanity/quickstart) encontrarás todos los pasos. ## Related questions - [¿Cómo traduzco contenido en Storyblok?](https://generaltranslation.com/es/kb/translate-storyblok-content.mdx): En Storyblok, agrega tus idiomas de destino al espacio y asigna a cada campo traducible un valor por idioma. La integración de Storyblok de General Translation rellena esos valores desde el panel de control con Sincronizar y aplicar, como borradores que luego revisas y publicas en Storyblok. - [¿Cómo traduzco un sitio de documentación de Mintlify?](https://generaltranslation.com/es/kb/translate-mintlify-docs.mdx): Crea una copia traducida de cada página en una carpeta por idioma y añade cada idioma a la navegación de docs.json. El agente de IA de General Translation, Locadex, abre un pull request que añade las páginas traducidas y la navegación por idioma, y después traduce los cambios posteriores. - [¿Cómo traduzco Google Slides?](https://generaltranslation.com/es/kb/translate-google-slides.mdx): Copia la presentación una vez por idioma, reemplaza el texto de cada cuadro de texto, celda de tabla y nota del orador, y ajusta el tamaño del texto que se desborde. La integración de Google Drive de General Translation guarda cada idioma en su propia copia junto a la presentación de origen y aplica una pasada de formato para adaptar el nuevo texto a cada diapositiva. - [¿Cómo reviso y edito traducciones?](https://generaltranslation.com/es/kb/review-translations.mdx): Compara cada traducción con su texto de origen y con las demás configuraciones regionales, y corrige lo que no suene bien. Con General Translation, editas las traducciones en la Página de traducciones del panel de control y haces seguimiento de la revisión con etiquetas y comentarios. Después, la siguiente ejecución de traducción de Locadex, su Agente de IA, incorpora los cambios en un pull request. ## Previous and next questions - Previous question: [¿Cómo traduzco cadenas fuera de JSX?](https://generaltranslation.com/es/kb/translate-strings-outside-jsx.mdx) - Next question: [¿Cómo traduzco contenido en Storyblok?](https://generaltranslation.com/es/kb/translate-storyblok-content.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/es/kb/sitemap.md) for every article.