Target File Bundles

Target file bundles or simply Bundles is the feature that allows you to export sets of strings or files in the formats you select, regardless of the original file format. By default, you can choose from the following three formats: XLIFF, Android XML, and iOS Strings. You can add more target file formats by installing respective applications from the Crowdin Marketplace.

You can work with bundles in a few different ways:

  • Manage bundles manually via the Project settings.
  • Connect a VCS integration in the Target file bundles mode.
  • Manage bundles using OTA Content Delivery.
  • Manage bundles using Crowdin CLI and API.

Use Cases

The most common use cases are the following:

  • You can upload a single source file (e.g., Android XML) to your project, translate it and then, using bundles, export translations for multiple platforms (e.g., Android XML for the Android app, iOS strings for the iOS app, JSON for the web app, etc.).
  • You can have a single spreadsheet (e.g., XLSX or CSV) where you store source strings for all platforms your app is developed for, and each string is labeled with a respective label. Upload this file to your project, translate it, and then create separate bundles for multiple platforms using a combination of source file paths and string labels.
  • You can localize your mobile app without source files by combining Crowdin design tool plugins (Figma, Sketch, Adobe XD) to send strings straight to the Crowdin Enterprise project and export translations in the preferred formats using bundles.
  • You can export specific sets of strings for offline translation in XLIFF format and then upload finished translations back to Crowdin Enterprise.

Bundles in Project Settings

To work with bundles manually, you can configure them in Project settings and build and download them via Project home.

Configuring Bundles

To configure a bundle, follow these steps:

  1. Open your project and go to the Project settings.
  2. Scroll down to the Target File Bundles section.
  3. Click Add bundle.
  4. In the appeared page, name your bundle.
  5. Specify the source and resulting file paths. If needed, you can add multiple source path patterns using . In the right panel, you can preview the structure of the source and translation files based on the specified paths.
  6. (Optional) To ignore some folders or files, select Ignore files or folders, specify their respective pattern, and Crowdin Enterprise will skip these specific files or folders during the bundle generation. If needed, you can add multiple ignore patterns using .
  7. (Optional) You can specify labels in the Labels field to filter strings included in the bundle. Read more about Labels.
  8. Select the file format you’d like your strings to be exported in. To add other formats, install the respective applications from our Marketplace.
    Note: You can select only one format at once within a single bundle.
  9. Click Create.

Create bundle

Downloading Configured Bundles

You can download configured bundles either via your Project home or the Project settings.

To download configured bundles via Project home, follow these steps:

  1. Open your project and go to Project home.
  2. Click Download.
  3. In the appeared dialog, select Bundle and select the needed bundle from the drop-down list.
  4. Click Download.
  5. Once the bundle build activity is completed, click Download.

Download bundle from the Home tab

To download configured bundles via the Project settings, follow these steps:

  1. Open your project and go to the Project settings.
  2. Scroll down to the Target file bundles section.
  3. Click Build towards the needed bundle.
  4. Once the bundle build activity is completed, click Download.

Download bundle from the Settings tab

The system will build and download a ZIP archive with folders for each of the project’s target languages containing the translation files of the selected format.

Note: The download of the configured bundles works independently of the full project build download.

Editing Bundles

To edit configured bundles, follow these steps:

  1. Open your project and go to the Project settings.
  2. Scroll down to the Target file bundles section.
  3. Click towards the needed bundle and select Edit. Alternatively, just click on the needed bundle.
  4. Make the necessary edits and click Save.

Edit bundle

Deleting Bundles

To delete bundles, follow these steps:

  1. Open your project and go to the Project settings.
  2. Scroll down to the Target file bundles section.
  3. Click towards the needed bundle and select Delete.
  4. Confirm the deletion by clicking Delete in the appeared dialog.

Delete bundle

Bundles in VCS Integrations

VCS integrations allow you to work with bundles using the Target file bundles mode.

To configure a VCS integration that works in Target file bundles mode, follow these steps:

  1. Once you select Target file bundles mode and authorize the connection with Crowdin Enterprise on the VCS side, select the repository and branches to which you want to send translations.
  2. Click to start the configuration of the selected branch.
  3. In the Branch Configuration dialog, specify the preferred name for your configuration file or leave it as is and click Continue.
  4. Name your bundle.
  5. Specify the source and resulting file paths. If needed, you can add multiple source path patterns using . In the right panel, you can preview the structure of the source and translation files based on the specified paths.
  6. (Optional) To ignore some folders or files, select Ignore files or folders, specify their respective pattern, and Crowdin Enterprise will skip these specific files or folders during the bundle generation. If needed, you can add multiple ignore patterns using .
  7. (Optional) You can specify labels in the Labels field to filter strings included in the bundle. Read more about Labels.
  8. Select the file format you’d like your strings to be exported in. To add other formats, install the respective applications from our Marketplace.
    Note: You can select only one format at once within a single target file bundle filter.
  9. Click Save changes to save your target file bundle filter. You can add as many filters as you need.
  10. Once you’ve added all the needed filters In the Branch Configuration dialog, click Save.
  11. To complete the VCS integration configuration, click Save in the dialog where you selected your repo and branches.

VCS Target File Bundles Mode

Read more about configuring VCS integrations online.

Bundles in OTA Content Delivery

To add a distribution that exports translations using bundles, follow these steps:

  1. Open your project and go to Tools > Content Delivery.
  2. Add new distribution using the Add distribution button.
  3. In the appeared dialog, name your distribution.
  4. Select only the files, translations for which you want to be shown in your application.
  5. Select Target file bundles in the Export options section.
  6. Select the file format you’d like your strings to be exported in. To add other formats, install the respective applications from our Marketplace.
    Note: You can select only one format at once within a single distribution.
  7. Specify the target file pattern.
  8. (Optional) You can select labels in the Labels field to filter strings that will be included in the distribution. Read more about Labels.
  9. Click Next.
    OTA Content Delivery Bundles
  10. Copy the distribution hash so you can use it for integration.

Read more about OTA Content Delivery.

Bundles in CLI/API

You can also export translations using bundles when working with Crowdin CLI and API.

Read more about Bundles in CLI.

Read more about Bundles in API.

Was this article helpful?