Skip to main content

How to manage CDN distributions and releases?

Distributions and releases structure how translated files are packaged, versioned, and delivered over-the-air (OTA) to your applications.

To fetch these published translations in your mobile app or backend, you need a key to authenticate your requests. To learn how to generate and configure CDN keys, see our guide.

Key concepts

  • Distributions: Delivery channels configured for specific app types (e.g., LingoHub SDK Android, iOS, or Native zip format) and environments (e.g., Development or Production).

  • Releases: Zipped translation files assigned to a distribution. When a distribution receives a fetch request from an app, LingoHub delivers whichever release is currently set as Live.

  • Versions: Rules that map distributions to specific app versions.

    • Version ranges: Designed to handle legacy distributions or major file structure changes without causing issues in older app versions.

    • All versions: Acts as an automatic fallback if no specific version rule is matched.

How to manage distributions

1. Create a distribution

  1. Go to Projects in the top navigation bar and select your project.
    ​

  2. Click Settings and select the CDN tab.
    ​

  3. Click + Create a distribution under the Distributions section.
    ​

  4. In the popup:

    • Enter a Distribution name.

    • Select a Distribution type (Native format, LingoHub SDK Android, or LingoHub SDK iOS).

    • Select a Distribution environment (Development, Test, Staging, or Production).
      ​
      💡 Important: Use separate environments (e.g., Test and Production) to safely test translation updates in staging before pushing them to end users.
      ​

    • Choose target Versions (All versions or Version range).
      ​
      💬 Please note: Older distributions can continue using earlier versions if file structures change drastically in newer app updates. Setting All versions acts as a reliable fallback whenever no specific version is requested.
      ​
      Version strings accept numbers and dots only. Alphabetic characters or build tags (e.g., 1.1.3.a) are invalid. The end version must be strictly greater than the start version. Reversed ranges (e.g., 2.1.3-2.0.3) will fail validation.
      ​
      ​We validate version ranges by default.
      ​

  5. Click Create a distribution to save.
    ​

💬 Please note: The Distribution type and Distribution environment settings cannot be changed after creation.

2. Edit or delete a distribution

  1. In the Distributions table, locate your entry and click the three dots menu icon on the right.
    ​

  2. Click Edit to modify its properties or click Delete to remove the distribution.
    ​

How to manage releases

1. View distribution details & release history

Click directly on any distribution row or distribution name (e.g., Default) in the table to open its detail overview page. You can also click Edit in the top right to update general distribution settings.
​

2. Create and publish a new release

  1. Inside the distribution detail page, click + Create a release.
    ​

  2. Enter a Release name (e.g., release-v2) and select the target languages to include in the bundle.

  3. Check Set the release live to deploy immediately, then click Create a release.
    ​

3. Switch live releases

To roll back or make a previous release active:

  1. Open the distribution detail page.
    ​

  2. Locate the desired release in the All releases table.

  3. Click Set live next to that release.
    ​

4. Download release files

Click the three-dot menu icon next to any release in the table, then select Download to export the packed zip file directly to your device.
​


Need more help?

Couldn't find what you were looking for? Reach out to our team at [email protected], and we will gladly assist you.
​

Related Articles
Did this answer your question?