Content Delivery

Distribution is a CDN vault that mirrors your project’s translated content and is required for integration with the iOS, Android, or Web apps.

Distribution Setup

To configure a distribution, 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 one of the following export options:
   • Default export – export translations in the original format of the selected files.
   • Target file bundles – export translations in the selected format regardless of the original format of the selected files. Read more about configuring target file bundles for distribution.
6. Click Create.
   
7. Copy the distribution hash so you can use it for integration.
   
8. Сreate as many distributions as you need and select different files for each. You’ll need to click Release next to the needed distribution every time you want to send new translations to the app.
   

For Mobile Applications

To send the translated content to your mobile apps via content delivery, use the Crowdin SDKs:

• iOS SDK
• Android SDK

For Web Applications

To send the translated content to your web apps via content delivery, use the Crowdin OTA JavaScript client.

Read more about Crowdin OTA JavaScript client.

To manage the translated content delivery to your web apps manually, use the following instructions:

Form the URL to the translation file the following way:

https://distributions.crowdin.net/{distribution_hash}/content/{path_to_file}

{path_to_file} will be the same as for the regular translation build. If your files don’t have export patterns with the language code placeholders (e.g., %locale%, %two_letters_code%, etc.), the system will automatically add the Crowdin language code at the beginning of the path.

You can find the list of your project language codes in the meta-information about your distribution content:

https://distributions.crowdin.net/{distribution_hash}/manifest.json

Pricing

A request is considered any single query to a CDN (e.g., a request to a distribution manifest, a request to a distribution file, etc.).

Data transfer is the amount of data transferred over the network (including headers). The system delivers your language packages via CDN, containing all the existing translations.

If the distribution contains content divided into multiple files, a request to download each file is counted as a separate request. Additionally, the volume of files is also counted as a data transfer.

For example, if a distribution contains 20 files, each of which is 5MB, the download is counted as 20 requests and 100MB of data transfer.

To reduce requests to the CDN, you can put all the necessary content into one file (using Bundles), and when it is downloaded, the system counts one request instead of 20 separate ones. Additionally, caching configuration can be made on the app’s side.

In our statistics, we use data provided by AWS. If 1,000,001 (1 million and 1) requests are made in a month, the price for requests will be $6. If 10GB and 1 byte are transferred in a month, the price for data transfer will be $4. The combined total will be $10 per month for requests and data transfer.