How do I create a Pull Request (PR)?

To create a new pull request on GitLab with all the changes made on Lokalise, proceed to the Download page and find the App triggers section. Enable the GitLab option and choose your repository. If the Repository name has been provided during the initial setup, you'll see it in the dropdown. Use the Preview button first, so you can see the resulting file/folder structure before triggering the creation of a pull request. We recommend triggering pull requests only to the repos of the platform that match the file type you are exporting, i.e. if you are exporting in a JSON format, Lokalise will only create pull requests in repositories with the Web platform. To create a pull request on GitLab, hit Build only (this way you won't download a translation bundle to your local PC). To check the status of the pull request creation, return to the GitLab app page and click the Logs button.

How do I create a personal access key in GitLab to use in Lokalise?

Proceed to GitLab. Click on your avatar in the top right corner and click Preferences. Check that you have permissions for project administration and setting management. Next, click Access tokens, click Add new token, enter the new token's name and enable the API scope. Click Create personal access token. Copy the token as you won't be able to view it after closing the page.

I have updated strings in my GitLab 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 GitLab app settings in Lokalise. 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 app's 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.

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 GitLab app does not alter the repo's settings.

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

GitLab 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 GitLab account. GitLab 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.

Integración nativa con GitLab

Automatiza la localización de contenido de GitLab para publicaciones multilingües más rápidas

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

Conecta GitLab con Lokalise

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

«Poder usar comandos pull y push ha sido fantástico. 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 GitLab y Lokalise

Traduce tu software con solo unos clics.

Automatiza la introducción y actualización de claves

Extrae archivos automáticamente cuando envías cambios a GitLab y crea claves al instante en Lokalise, listas para su localización.

Organiza la localización con GitLab

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 los proyectos

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 claves de traducción

Dile adiós a la aburrida introducción manual de claves, reduce los errores de localización y lanza versiones multilingües más rápido.

⚙️ Cómo configurar
Lokalise y GitLab

Ve al panel «Apps» dentro de Lokalise

Busca GitLab y haz clic en Instalar

Copia y pega tu token de acceso personal de GitLab y la URL de tu host (suele ser simplemente https://gitlab.com).

Introduce tu ID de proyecto y la rama de la que quieres extraer. Puedes indicar un nombre de proyecto.

🔧 Qué necesitarás

Un token de acceso personal de GitLab

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

Ver documentación

💡 Gestión de archivos de traducción con GitLab y Lokalise

Importar

Extrae tus archivos de GitLab a Lokalise para crear automáticamente claves de todos los idiomas seleccionados en Lokalise.

Traducir

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

Exportar

Fusiona archivos en una rama seleccionada en GitLab. Ve a la pestaña Descarga, elige el formato de archivo y haz clic en Compilar.

«Antes de Lokalise, los desarrolladores tardaban al menos medio día en gestionar las traducciones y añadir nuevas claves. Ahora, con Lokalise, dedican aproximadamente un 80-90 % menos de tiempo a las mismas tareas».

Sylvia Taube

Responsable de producto sénior en Indeavor

«La infraestructura y la arquitectura de la herramienta son realmente buenas. Solo tenemos que crear tareas y los traductores se encargan del resto. Además, todo el proceso de gestión de proyectos se simplifica considerablemente».

Aleš Ruter

Director creativo

Sylvia Taube

Responsable de producto sénior en Indeavor

Aleš Ruter

Director creativo

💡 Consejo: Automatiza el intercambio de contenido

Configura un webhook en GitLab para automatizar las extracciones a Lokalise cuando envíes cambios a GitLab. En GitLab, 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 GitLab. Por último, activa el desencadenador de eventos Push.

Sincroniza archivos de traducción fácilmente

Intercambia archivos de traducción entre GitLab y Lokalise.

Conecta GitLab con Lokalise Regístrate en Lokalise gratis

Preguntas frecuentes

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

Para crear una nueva solicitud de extracción o pull request en GitLab con todos los cambios realizados en Lokalise, ve a la página Descarga y busca la sección Activadores de la aplicación. Activa la opción de GitLab y elige tu repositorio. Si el nombre del repositorio se proporcionó durante la configuración inicial, lo verás en el menú desplegable. Usa primero el botón Vista previa para ver la estructura de archivos y carpetas resultante antes de activar la creación de una solicitud de extracción. Recomendamos activar las solicitudes de extracción solo en los repositorios de la plataforma que coincidan con el tipo de archivo que estás exportando; es decir, si exportas en formato JSON, Lokalise solo creará solicitudes de extracción en repositorios con la plataforma Web. Para crear una solicitud de extracción en GitLab, haz clic en Solo compilar (de este modo no descargarás un paquete de traducción en tu PC local). Para comprobar el estado de la creación de la solicitud de extracción, vuelve a la página de la aplicación de GitLab y haz clic en el botón Registros.

¿Cómo puedo crear una clave de acceso personal en GitLab para usarla en Lokalise?

Ve a GitLab. Haz clic en tu avatar en la esquina superior derecha y, luego, en Preferencias. Comprueba que tienes permisos para administrar proyectos y gestionar configuraciones. A continuación, haz clic en Tokens de acceso, luego en Añadir nuevo token, introduce el nombre del nuevo token y activa el permiso de la API. Haz clic en Crear token de acceso personal. Copia el token, ya que no podrás verlo después de cerrar la página.

He actualizado cadenas en mi archivo de GitLab, 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 GitLab en Lokalise. 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 de la aplicació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.

¿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 GitLab 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 GitLab 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 GitLab del usuario que autoriza la integración.

Los usuarios de GitLab siempre pueden revocar un token o editar los permisos 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.

Automatiza la localización de contenido de GitLab para publicaciones multilingües más rápidas

«Poder usar comandos pull y push ha sido fantástico. 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 GitLab y Lokalise