Back to Blog
Tutorial

How to Migrate from Lokalise to IntlPull (Step-by-Step Guide)

Complete migration guide from Lokalise to IntlPull. Learn how to transfer all your projects, translations, TM, and glossary in under 10 minutes.

IntlPull Team
IntlPull Team
Engineering
November 5, 20247 min read

Overview

Migrating from Lokalise to IntlPull takes about 10 minutes and preserves:

  • All projects and their structure
  • All translation keys and values
  • All languages
  • Translation memory entries
  • Glossary/terminology
  • Comments and context
  • Prerequisites

    Before starting:

  • Lokalise API key with read access to projects
  • IntlPull account (sign up free)
  • Node.js 18+ (for CLI migration)
  • Method 1: CLI Migration (Recommended)

    The fastest way to migrate everything at once.

    Step 1: Install IntlPull CLI

    npm install -g @intlpull/cli

    Step 2: Get Your Lokalise API Key

  • Log into Lokalise
  • Go to Profile Settings → API Tokens
  • Create a new token with Read-only access
  • Copy the token
  • Step 3: Run Migration

    npx intlpull migrate --from lokalise

    You'll be prompted for:

  • Lokalise API key
  • IntlPull API key (get from IntlPull dashboard)
  • Projects to migrate (all or select specific ones)
  • Step 4: Verify

    Once complete, check your IntlPull dashboard to verify:

  • All projects appear
  • All languages are present
  • Translation counts match
  • Method 2: Web Migration

    If you prefer a visual interface:

    Step 1: Go to Migration Page

    Visit intlpull.com/migrate and select "Lokalise" as your source.

    Step 2: Connect Lokalise

    Enter your Lokalise API key. IntlPull will fetch your project list.

    Step 3: Select Projects

    Choose which projects to migrate:

  • Select all for complete migration
  • Or pick specific projects
  • Step 4: Configure Options

  • Import TM: Yes (recommended)
  • Import Glossary: Yes (recommended)
  • Import Comments: Yes (recommended)
  • Step 5: Start Migration

    Click "Start Migration" and wait for completion. You'll see progress for each project.

    Method 3: Manual Export/Import

    For more control, export from Lokalise and import to IntlPull.

    Export from Lokalise

  • Open your Lokalise project
  • Go to Download
  • Select format: JSON (Structured)
  • Select all languages
  • Click Build and Download
  • Export Translation Memory

  • Go to Translation Memory
  • Click Export
  • Download as TMX or CSV
  • Export Glossary

  • Go to Glossary
  • Click Export
  • Download as TBX or CSV
  • Import to IntlPull

  • Create a new project in IntlPull
  • Go to Import
  • Upload your JSON files
  • Go to Translation Memory → Import
  • Upload your TM file
  • Go to Glossary → Import
  • Upload your glossary file
  • Post-Migration Steps

    1. Update CI/CD Pipelines

    Replace Lokalise CLI commands with IntlPull:

    # Before (Lokalise)
    lokalise2 file download --project-id xxx
    
    # After (IntlPull)
    npx intlpull pull

    2. Update Environment Variables

    # Remove
    LOKALISE_API_TOKEN=xxx
    LOKALISE_PROJECT_ID=xxx
    
    # Add
    INTLPULL_API_KEY=xxx
    INTLPULL_PROJECT_ID=xxx

    3. Set Up OTA (Optional)

    If you want instant translation updates for mobile apps:

    iOS:

    import IntlPull
    
    IntlPull.configure(
        projectId: "your-project-id",
        apiKey: "your-api-key"
    )

    Android:

    IntlPull.configure(
        projectId = "your-project-id",
        apiKey = "your-api-key"
    )

    4. Invite Team Members

  • Go to Project Settings → Team
  • Invite translators and developers
  • Set appropriate roles
  • 5. Cancel Lokalise Subscription

    Once verified:

  • Export a final backup from Lokalise (just in case)
  • Cancel your Lokalise subscription
  • Enjoy your savings!
  • Troubleshooting

    "Invalid API Key" Error

  • Ensure your Lokalise token has read access
  • Check for extra spaces when copying
  • Generate a new token if needed
  • Missing Translations

  • Verify all languages were selected during export
  • Check if translations were in "draft" status in Lokalise
  • Re-run migration for specific languages if needed
  • TM Not Importing

  • TM import requires Pro plan or higher
  • Check file format (TMX or CSV)
  • Contact support if issues persist
  • Rate Limiting

    For large projects, the migration might take longer due to API rate limits. The CLI handles this automatically with retries.

    Data Mapping

    LokaliseIntlPull
    ProjectProject
    KeyTranslation Key
    TranslationTranslation
    LanguageLanguage
    TM SegmentTM Entry
    Glossary TermGlossary Term
    TagTag
    CommentComment
    ScreenshotContext Image
    ProjectProject
    KeyTranslation Key
    TranslationTranslation
    LanguageLanguage
    TM SegmentTM Entry
    Glossary TermGlossary Term
    TagTag
    CommentComment
    ScreenshotContext Image
    ProjectProject
    KeyTranslation Key
    TranslationTranslation
    LanguageLanguage
    TM SegmentTM Entry
    Glossary TermGlossary Term
    TagTag
    CommentComment
    ScreenshotContext Image
    KeyTranslation Key
    TranslationTranslation
    LanguageLanguage
    TM SegmentTM Entry
    Glossary TermGlossary Term
    TagTag
    CommentComment
    ScreenshotContext Image
    TranslationTranslation
    LanguageLanguage
    TM SegmentTM Entry
    Glossary TermGlossary Term
    TagTag
    CommentComment
    ScreenshotContext Image
    LanguageLanguage
    TM SegmentTM Entry
    Glossary TermGlossary Term
    TagTag
    CommentComment
    ScreenshotContext Image
    TM SegmentTM Entry
    Glossary TermGlossary Term
    TagTag
    CommentComment
    ScreenshotContext Image
    Glossary TermGlossary Term
    TagTag
    CommentComment
    ScreenshotContext Image
    TagTag
    CommentComment
    ScreenshotContext Image
    CommentComment
    ScreenshotContext Image
    ScreenshotContext Image

    FAQ

    Q: Will I lose any data?

    A: No. All translations, TM entries, and glossary terms are preserved.

    Q: Can I migrate multiple projects?

    A: Yes. The CLI can migrate all projects at once.

    Q: How long does migration take?

    A: Usually 5-10 minutes for most teams. Large projects (100k+ strings) may take longer.

    Q: Can I keep using Lokalise during migration?

    A: Yes. Migration is read-only on the Lokalise side.

    Q: What if something goes wrong?

    A: Contact our support team. We'll help ensure complete migration.

    Cost Comparison

    After migration, you'll likely see significant savings:

    StringsLokaliseIntlPullSavings
    3,000~$90/mo$11/mo88%
    10,000~$150/mo$39/mo74%
    50,000~$400/mo$115/mo71%
    3,000~$90/mo$11/mo88%
    10,000~$150/mo$39/mo74%
    50,000~$400/mo$115/mo71%
    3,000~$90/mo$11/mo88%
    10,000~$150/mo$39/mo74%
    50,000~$400/mo$115/mo71%
    10,000~$150/mo$39/mo74%
    50,000~$400/mo$115/mo71%
    50,000~$400/mo$115/mo71%

    Summary

  • Get API keys from both platforms
  • Run migration via CLI or web interface
  • Verify data in IntlPull dashboard
  • Update integrations (CI/CD, mobile SDKs)
  • Cancel Lokalise and save money
  • Need help? Our migration support team is available at support@intlpull.com.

    Start your migration now →

    lokalise
    migration
    tutorial
    how-to
    Share:

    Ready to simplify your i18n workflow?

    Start managing translations with IntlPull. Free tier included.