How do I create a Pull Request (PR)?

Go to the Download page on Lokalise, select the relevant options, and trigger GitHub by ticking the GitHub checkbox. Then, click Build only. In this case, the PR will be created in your repo. If you have more than one repo linked to the project, select the appropriate one using the Filter repositories field.

I have updated strings in my GitHub file, but the values are not updating on Lokalise. What am I doing wrong?

Make sure that the ''Replace modified values'' option is enabled in the pull settings. You can read more about all the upload parameters in the Upload files article.

How do I make sure the file structure in PR matches the file structure in my repository?

To match the right structure of your files, you have to name files properly and select the right options when creating a PR. This is easy when enabling "Include full path in the filenames" in the general GitHub app settings. Then during download, select "Multiple files per language (use assigned filenames)", and modify or delete the prefix. Please check the Filenames article for reference.

I have key names that repeat across files. How can I support repeated key names in Lokalise?

To support repeated key names in Lokalise, make sure that the "Differentiate keys by file" option is enabled in the pull settings.

Why does Lokalise request access to all my repositories?

Lokalise requests access to all repositories to list them during setup so you can specify which repository to connect to Lokalise. There is no more restrictive OAuth scope for this purpose. Once the app is configured, Lokalise only works with the repository you selected. Admin scopes are not required.

What actions does the app use the OAuth token for?

Lokalise only creates merge requests and fetches the files you selected during setup. The Lokalise GitHub app does not alter the repo's settings.

Is there any way to restrict the app's permissions?

GitHub user permission scopes limit access for OAuth tokens. The Lokalise app's access is limited by the permissions of the user who configures the integration. If you need to limit the integration's access to a specific repository, you can do so by limiting the permissions of the authorizing user's GitHub account. GitHub users can always revoke a token or edit the token scopes for more control over what the integration can do.

How is my access token stored?

Your token is stored in an encrypted form in our database. The database itself is stored on dedicated servers at the Hetzner Online provider, which ensures top-level physical security. You can learn more on the Hetzner website. We take regular snapshots of the database and store them in a 256-bit encrypted Amazon S3 bucket for 30 days.

Can I use GitHub Actions in Lokalise?

Yes. You can manipulate any object or data in your Lokalise workspace that's accessed using the Lokalise CLI or API with GitHub Actions. Learn more about how to use Github Actions in Lokalise.

Integración nativa con GitHub

Automatiza la traducción de contenido en GitHub para una localización sencilla

Intercambia automáticamente archivos de idioma entre GitHub y Lokalise para importar y exportar contenido en cuanto esté listo. Además, mantén el software actualizado en todos los idiomas.

Conecta GitHub con Lokalise

Descubre cómo funcionan GitHub y Lokalise

Los equipos tecnológicos de más de 3000 empresas con presencia internacional ya confían en Lokalise

«Los ingenieros no tienen que perder el tiempo subiendo y bajando las traducciones. Es genial».

Kate Cobb

Ingeniera sénior Full Stack

Gestiona los archivos de traducción en un solo lugar con GitHub y Lokalise

Traduce los archivos de idioma alojados en GitHub con solo unos clics.

Automatiza la introducción y actualización de claves

Configura extracciones automáticas para intercambiar archivos de idioma entre GitHub y tu proyecto de Lokalise.

Organiza la localización con GitHub

Tendrás siempre la certeza de estar trabajando con las versiones de archivo más recientes. Reduce el riesgo de cometer errores y fallos.

No te pierdas ninguna actualización de las traducciones

Gestiona cuándo y cómo intercambias información con webhooks y controla el estado de las tareas de localización.

Ahorra tiempo cuando actualices archivos

Olvídate de los procesos de localización manuales y lentos en los que se pierden archivos, se producen errores y hay retrasos.

GitHub Actions en Lokalise

Disfruta de nuestras GitHub Actions de código abierto, una solución lista para usar con una configuración mínima (unas 5 líneas de código) que te permite programar importaciones y exportaciones, e incluso combinarla con otras soluciones (por ejemplo, para fusionar automáticamente pull requests [solicitudes de extracción] con las traducciones actualizadas).

Documentación de GitHub Actions

⚙️ Cómo configurar
Lokalise y GitHub

Ve al panel «Apps» dentro de Lokalise

Busca GitHub y haz clic en Instalar

Haz clic en Conectar y concede permisos de acceso a Lokalise.

Introduce el nombre del repositorio (con el prefijo del nombre de tu organización) y la rama de la que quieres exportar.

🔧 Qué necesitarás

Necesitarás crear un proyecto web y móvil en Lokalise

Ver documentación

Gestión de traducciones con GitHub y Lokalise

Importar

Elige tus archivos de idioma base en GitHub e impórtalos a Lokalise.

Traducir

Usa la traducción con IA integrada para obtener contenido multilingüe preciso en minutos.

Exportar

Ve a la pestaña Descarga en Lokalise, elige el formato de archivo y descarga las traducciones en GitHub.

«Nuestros desarrolladores se niegan a trabajar con cualquier otro software de localización. Solo quieren usar Lokalise. Ahorran tiempo y energía, y así se evitan muchos dolores de cabeza».

Gaia Castronovo

Especialista en localización educativa

«Uno de los beneficios es que este proceso no requiere mucho trabajo manual. Queríamos que el proceso de lanzamiento y desarrollo de nuestra aplicación fuera ágil y fluido. Con Lokalise, es posible».

Yoni Lindenfeld

Cofundador y vicepresidente de Ingeniería

«Nuestros desarrolladores se niegan a trabajar con cualquier otro software de localización. Solo quieren usar Lokalise. Ahorran tiempo y energía, y así se evitan muchos dolores de cabeza».

Gaia Castronovo

Especialista en localización educativa

Yoni Lindenfeld

Cofundador y vicepresidente de Ingeniería

💡 Cómo configurar la traducción automática en GitHub

Configura un webhook en GitHub para enviar el contenido a Lokalise en cuanto publiques cambios en GitHub. En GitHub, ve a Configuración > Webhooks > Añadir webhook. Copia y pega la URL de extracción automática y la clave secreta de extracción automática de Lokalise en GitHub. Por último, activa el desencadenador de eventos Push.

Obtén traducciones del contenido de GitHub en minutos

Intercambia automáticamente archivos de traducción entre GitHub y Lokalise.

Conecta GitHub con Lokalise Regístrate en Lokalise gratis

Preguntas frecuentes

¿Cómo creo una solicitud de extracción o pull request (PR)?

Ve a la página Descarga en Lokalise, selecciona las opciones correspondientes y activa GitHub marcando la casilla de GitHub. A continuación, haz clic en Solo compilar. En este caso, la PR se creará en tu repositorio. Si tienes más de un repositorio vinculado al proyecto, selecciona el adecuado mediante el campo Filtrar repositorios.

He actualizado cadenas en mi archivo de GitHub, pero los valores no se actualizan en Lokalise. ¿Qué estoy haciendo mal?

Asegúrate de que la opción «Reemplazar valores modificados» esté habilitada en los ajustes de extracción. Puedes obtener más información sobre todos los parámetros de carga en el artículo Subir archivos.

¿Cómo me aseguro de que la estructura de archivos de la PR coincida con la estructura de archivos de mi repositorio?

Para que la estructura de tus archivos sea la correcta, debes nombrar los archivos adecuadamente y seleccionar las opciones correctas al crear una PR. Esto es sencillo si habilitas la opción «Incluir la ruta completa en los nombres de archivo» en la configuración general de la aplicación de GitHub. Luego, durante la descarga, selecciona «Varios archivos por idioma (usar nombres de archivo asignados)» y modifica o elimina el prefijo. Consulta el artículo Nombres de archivo como referencia.

Tengo nombres de clave que se repiten en varios archivos. ¿Cómo puedo admitir nombres de clave repetidos en Lokalise?

Para admitir nombres de clave repetidos en Lokalise, asegúrate de que la opción «Diferenciar claves por archivo» esté habilitada en los ajustes de extracción.

¿Por qué Lokalise solicita acceso a todos mis repositorios?

Lokalise solicita acceso a todos los repositorios para mostrarlos durante la configuración; de este modo puedes especificar a cuál conectarte en Lokalise. No existe ningún alcance de OAuth más restrictivo para este fin. Una vez configurada la aplicación, Lokalise solo trabaja con el repositorio que hayas seleccionado. No se requieren permisos de administrador.

¿Para qué acciones utiliza la aplicación el token de OAuth?

Lokalise solo crea solicitudes de fusión y obtiene los archivos que seleccionaste durante la configuración. La aplicación de GitHub de Lokalise no modifica la configuración del repositorio.

¿Hay alguna forma de restringir los permisos de la aplicación?

Los permisos de usuario de GitHub limitan el acceso a los tokens de OAuth. El acceso de la aplicación de Lokalise está limitado por los permisos del usuario que configura la integración. Si necesitas limitar el acceso de la integración a un repositorio específico, puedes hacerlo restringiendo los permisos de la cuenta de GitHub del usuario que autoriza la integración.

Los usuarios de GitHub siempre pueden revocar un token o editar los permisos relacionados con ese token para tener mayor control sobre lo que puede hacer la integración.

¿Cómo se almacena mi token de acceso?

Los token de acceso se cifran y se almacenan en nuestra base de datos. La base de datos en sí se almacena en servidores dedicados del proveedor Hetzner Online, que garantiza una seguridad física de primer nivel. Puedes obtener más información en el sitio web de Hetzner.

Realizamos snapshots o instantáneas del estado de la base de datos y las almacenamos en un bucket de Amazon S3 cifrado con AES de 256 bits durante 30 días.

¿Puedo usar GitHub Actions en Lokalise?

Sí. Puedes manipular cualquier objeto o dato en tu espacio de trabajo de Lokalise al que se acceda mediante la CLI o la API de Lokalise con GitHub Actions. Obtén más información sobre cómo usar GitHub Actions en Lokalise.

Automatiza la traducción de contenido en GitHub para una localización sencilla

«Los ingenieros no tienen que perder el tiempo subiendo y bajando las traducciones. Es genial».

Gestiona los archivos de traducción en un solo lugar con GitHub y Lokalise