Localizeflow Docs
English
English Korean Japanese Chinese Spanish French
Try Localizeflow

Use cases

Educational repositories

Learn how to use Localizeflow to translate your educational repositories.

Educational repositories evolve quickly.

Lessons change. Examples are updated. New exercises are added.

Keeping multiple languages in sync manually is difficult and time-consuming.

Localizeflow ensures that every update in your source language is automatically reflected across all translated versions through pull requests.

Prerequisites

  • A GitHub account.
  • Access to the GitHub organization or repository you want to translate.

Installing the Localizeflow GitHub App on a GitHub organization requires that you are an organization owner. If you are not an owner, share this page with an owner and ask them to complete the installation step for you.

Prepare your repository (optional)

If you already maintain manual translations (e.g. README.ko.md or docs/ja/), remove them before enabling automation so your default language remains the single source of truth.

Sign in and install the Localizeflow GitHub App

  1. Visit localizeflow.com.

  2. Sign in with GitHub. Sign in with GitHub

  3. Select Install in new account.

  4. Choose the account where you want to install the Localizeflow GitHub App — your personal account or an organization you manage.

    Installing the app in a GitHub organization requires organization owner permissions. If you are not an owner, share this page with an owner and ask them to complete the installation step for you.

  5. Select the repositories you want Localizeflow to access, then choose Save. Select repo and save

  6. You will be redirected to the Localizeflow dashboard.

If an organization owner installed the Localizeflow GitHub App, they can invite teammates from the Team page in the sidebar, either by sending email invitations or sharing an invite link.

Team

To add more repositories later, select your account in the header and choose + Add more repositories. Add more repositories

Connect your repositories to Localizeflow

  1. On the Localizeflow home page, select + Connect repositories. Select connect repositories

  2. Select one or more repositories, then select Save.

  3. Connected repositories will appear on both the Home and Repositories pages.

Run your first translation

After connecting your repository, select it from the dashboard to open the onboarding wizard.

The wizard takes less than two minutes and defines:

  • Which languages
  • Terms that must remain unchanged

Step 1: Languages & target branch

Target languages

Select one or more target languages.
Localizeflow will generate and maintain pull requests for each selected language.

You can modify languages later from the repository settings.

Target branch

Choose the branch where translation pull requests should be opened.

  • In most cases, use your default branch (for example, main).
  • If you use a staging or documentation branch, select that instead.

If left empty, Localizeflow uses the repository’s default branch.

Step 1 – Select languages and target branch

Select Continue.

Step 2: Output location

Select project type

Educational repositories typically consist of Markdown files, notebooks, and image-based content rather than framework-driven documentation sites.

For educational repositories, select:

  • Simple repository.

Step 2 – Select project type

If you need full control over source and target paths, you can select Structured documentation site instead and configure translation groups manually.

Translation options

You can enable additional processing:

  • Markdown (default)
  • Image translation (beta) (not available for documentation sites)
  • Notebook translation
  • Add disclaimer to translations

For most educational repositories, we recommend:

  • Markdown
  • Image translation
  • Notebook translation

This ensures that lesson materials, screenshots, and Jupyter notebooks remain consistent across languages.

Select Continue.

Step 3: Glossaries & final checklist

Before automation begins, you can define terms that must remain unchanged during translation.

Glossaries help preserve:

  • Product names
  • Company names
  • Feature names
  • Legal or compliance phrases

Add one term per line. Each term remains unchanged in generated translations.

Example:

Localizeflow
Co-op Translator
GitHub App

You can edit or attach additional glossaries later.

Final checklist

Before selecting Save & Finish, verify:

  • Source paths correctly match your Markdown file locations.
  • Existing manual translations will not conflict with generated output.
  • Outdated translated folders have been removed if necessary.

This checklist helps prevent duplicate files and broken links.

Start automation

After selecting Save & Finish, you will be redirected to the repository detail page.

Translation does not begin automatically.

To start automatic translation:

  1. Select Automate.
  2. Localizeflow scans your repository.
  3. Translation jobs are generated.
  4. Draft pull requests are opened automatically.

Automation is disabled by default.

Once enabled, Localizeflow continuously monitors your repository and keeps all languages synchronized whenever lessons or materials change.

You can pause automation at any time using Pause automate.