# Untwine

Descriptor: Articulate XLIFF Import Repair

Canonical URL: https://kikuai.dev/fix-articulate-xliff-import-error/

Brand: KikuAI

Category: browser-local file diagnostic tool for Articulate XLF/XLIFF import failures.

Last updated: 2026-06-19

## What It Does

Untwine compares an untouched original Articulate XLF/XLIFF export with the translated file returned from a translation workflow.

The tool diagnoses why Rise or Storyline may reject the translated file, shows whether a deterministic repair is safe, and returns one of two artifacts:

- repaired XLF, only when the structural repair is deterministic;
- diagnosis report, when the file needs manual review or is unsupported.

## Buyer / Operator

Useful for instructional designers, course owners, localization operators, translators, and eLearning teams that need to import translated Articulate Rise or Storyline files back into the matching course.

## Input To Output

Input:

- original Articulate XLF/XLIFF export;
- translated XLF/XLIFF file from the same course workflow.

Action:

- compare segment IDs, targets, protected inline tags, encoding metadata, and course-file structure indicators in the browser.

Output:

- repaired XLF when safe;
- diagnosis report when automatic repair is unsafe;
- unsupported verdict when the file is outside the supported Articulate XLIFF scope.

## Supported Cases

- Original and translated Articulate XLF/XLIFF files are both available.
- The file came from an Articulate Rise or Storyline translation workflow.
- The likely problem is changed trans-unit IDs, missing targets, protected tag drift, encoding drift, or course-copy mismatch.
- The user needs a practical import artifact, not a translation or proofreading tool.

## When Vendor Fixes Do Not Help

Some Articulate import failures are product bugs that should be solved by an Articulate update or support path.

Untwine is for the other case: the original export imports cleanly, but the translated file no longer matches the same course structure.

Still worth checking:

- the course was edited or duplicated after export;
- the translation tool changed IDs, namespaces, segmentation, or protected tags;
- the translated file is missing expected XLIFF `file` / `body` structure;
- the original file imports but the translated file does not.

Untwine is not a vendor-bug detector. It gives a local report when the translated file itself appears to have drifted from the original export.

## Unsupported / Not For

- Generic XLIFF translation, proofreading, or terminology QA.
- Files without the matching original Articulate export.
- Rebuilding missing course structure after heavy manual XML edits.
- Cloud upload or private human file review.
- A promise that every translated XLIFF file can be repaired.

## Privacy Boundary

The file comparison runs in the browser. File contents are not sent to KikuAI during the local preview, repair download, or diagnosis report download. Interest forms, when used, send only the fields visible in the form and do not include file contents.

## Proof Assets

- Public tool page: https://kikuai.dev/fix-articulate-xliff-import-error/
- Sample diagnosis report: https://kikuai.dev/demo-files/articulate-xliff/sample-diagnosis-report.json
- Demo original XLF: https://kikuai.dev/demo-files/articulate-xliff/demo-articulate-original.xlf
- Demo repairable translated XLF: https://kikuai.dev/demo-files/articulate-xliff/demo-articulate-translated-safe-repair.xlf
- Demo manual-review translated XLF: https://kikuai.dev/demo-files/articulate-xliff/demo-articulate-translated-manual-review.xlf
- Source code: https://github.com/KikuAI-Lab/untwine

## Safe Public Claim

Use:

"Compare original and translated Articulate XLF/XLIFF files locally in your browser. Download a repaired XLF when safe, or a diagnosis report when it is not."

Avoid:

- "works on any XLIFF";
- "AI fixes every import error";
- "upload your file for review";
- "free forever";
- "generic translation QA".

## Questions This Page Can Answer

- How do I fix Articulate XLIFF import errors?
- Why does Rise say the translation file does not match this course?
- How can I check a translated Articulate XLF without uploading private files?
- What should I compare before importing a translated Storyline or Rise XLIFF file?
- When is an Articulate XLIFF repair safe, and when is it manual review only?