JsonCut

Localized image and video automation: a practical pipeline

Localize generated images and videos without broken layouts: text expansion budgets, font coverage, RTL checks and version-pinned templates.

Abstract geometric illustration for Localized image and video automation: a practical pipeline

Localized image and video automation breaks at the layout, not at the translation. A practical pipeline for text-expansion budgets, script coverage, right-to-left reviews and version-pinned templates that survive every market.

A translated layout is not a localized one

Abstract dark artwork with soft amber, teal, olive and violet colour blobs, a fine grid and subtle grain

Localized image and video automation fails in the same three places: a headline that outgrows its frame, a font with no glyph for the character you just translated, and a layout that assumes text runs left to right. None of these are translation problems — they appear only after the strings arrive.

The fix is not a bigger design system. Treat a localized creative as a template with per-locale inputs, a measured text budget, and a review step that looks at the render instead of the string table.

Three layers you localize separately

LayerWhat changesWhere it lives
CopyHeadline, subline, legal line, price formatLocale files or your translation tool
TypographyFont family per script, size, line height, letter spacingTemplate typography inputs
CompositionReading direction, badge position, image crop, safe areasTemplate version or a separate project

Most teams automate the first layer and hope the other two hold — until the first market that reads right to left or needs a wider character set. Keeping the layers apart makes a fix local: a size change for German does not touch the Japanese variant.

Budget for text expansion before you place a layer

Text expansion is the length difference between source and translation, and it hits short strings hardest. Published localization guidance gives a planning range against English.

Target languageTypical expansionNote for layout
German20–35%Compounds push buttons and labels furthest
Finnish20–30%Long words, few spaces to break on
French15–25%Punctuation spacing adds width
Spanish, Italian15–20%Usually fits a 25% reserve
Dutch, Polish15–25%Check the longest label, not the average
Portuguese, Russian10–20%Cyrillic needs wider glyph coverage
Arabic15–25%Plus the direction change below
Japanese−10 to +10%Shorter in characters, often taller
Chinese−20 to −10%Fewer characters, more vertical weight
Korean0 to +15%Mixed Hangul and Latin

The same guidance recommends designing for up to twice the English length, which sounds excessive until a two-word button grows by 80%. Measure the longest translated string per input and size the text box to it plus a margin. Averages lie; the longest string is what ships.

A pseudo-locale that pads every string by 40% with accented characters shows the damage before the translations exist.

Fonts: coverage beats style

A template that renders perfectly in English can produce empty rectangles in Vietnamese, Hindi or Arabic: the chosen font has no glyphs for those characters.

JsonCut stores fonts as media: WOFF2, WOFF, TTF and OTF files upload through the media API, and the workspace library keeps the same approved files available across projects — a stable font stack per script instead of a font name that resolves differently on each machine.

Script groupWhat to check before publishing
Latin extendedVietnamese diacritics, Polish and Czech glyphs, ligatures
Cyrillic, GreekComplete alphabet in both weights you ship
Arabic, HebrewJoined forms, vowel marks where used, direction support
CJKGlyph set for the characters used, not just the sample
Devanagari and other IndicConjuncts and matras in the specific font

CJK also changes vertical rhythm: the same point size often needs more line height than Latin. If your template exposes line height, that becomes a value per locale instead of a redesign.

Bind typography per locale

In JsonCut a published template exposes typed inputs, and typography is part of the bindable property groups: font size, color, background, line height and letter spacing can each be driven by a variable. That turns "German needs 92% of the headline size" into data instead of a manual edit.

InputTypeGerman valueJapanese value
headlinestring"Jetzt erhältlich""発売中"
headlineSizenumber5864
headlineLineHeightnumber1.051.25
headlineTrackingnumber00.02
showBadgebooleantruefalse

Number inputs can carry a minimum, maximum, step and unit, so a locale file cannot push a size into unreadable territory without failing validation. Discover the exact contract with GET /api/v2/templates/{id}/inputs first — the same discipline as in template input design.

ApproachWorks whenTrade-off
One template, one value set per localeSame composition, copy inside budgetOne version to maintain; a locale that needs a different composition breaks it
One template version per localeRTL, different typographic scale, market imageryParallel versions to approve and pin
Separate project per localeStructural differencesMost control, most maintenance

Publishing captures a project version, and a later edit does not silently mutate a published template. A German batch rendered in November keeps rendering the design approved in November — the same governance argument as in brand consistency for automated production.

Right-to-left is a layout decision

Arabic and Hebrew do not just flip the paragraph alignment. The Unicode Bidirectional Algorithm defines how characters of different directionality are ordered within a line, including numbers and paired brackets. That is the character level. It does not decide which side your logo sits on, which way a progress arrow points, or where a badge belongs.

ElementCommon failureLocalized decision
Headline and bodyText aligned right but margins unchangedMirror the padding, keep numerals LTR
Arrows, chevrons, progress barsPoint the wrong wayMirror the icon, not the whole image
Phone numbers, prices, URLsReordered or splitIsolate them; keep them LTR
Logos and badgesMove into the text columnDefine a mirrored safe area
Video captionsBurned-in left-aligned textReposition per direction

Test with real strings: a mirrored mock-up in English will not reveal how a mixed Arabic-and-number line resolves.

One batch per locale, pinned to one version

Localization multiplies rows. JsonCut bulk rendering accepts CSV or JSON, validates every row before queueing, and reports invalid rows without blocking the valid ones — the failure mode covered in why one bad row should not stop your bulk render.

PlanRows per batch
Hobby50
Pro250
Business500

A CSV body can be up to 2,000,000 characters, and every batch is pinned to one immutable template version. Give each row an explicit idempotency key that includes the locale, such as sku-1042-de, and keep one batch per locale so a failed German run does not requeue the French one.

Media retention belongs in the plan. Bulk inputs can be temporary, which suits one-off local product shots — but 48 hours is shorter than a campaign cycle. Product images per market belong in project or persistent storage, so a re-render next week still finds them.

A QA gate that catches what spellcheck misses

A localized render needs a look at the output, not only at the string table.

CheckPass conditionCatches
Pseudo-locale40% padded strings render without clippingTruncation, fixed boxes
Glyph auditLongest string shows no fallback boxesMissing characters
Expansion passLongest real translation fits its frameOverflow, overlap
Bidi passNumbers, brackets and arrows read correctlyReordered text, wrong icons
Native reviewA native speaker signs the final renderTone, false friends, formats

Keep the reviewed render next to the template version, not in a chat thread. When someone asks why the Italian banner used 44 px instead of 48 px, the answer should be a version and a value.

Nothing here translates for you

This pipeline does not translate. JsonCut renders the strings, fonts and values you send; translation, terminology and legal review stay with your localization tooling or agency. A renderer should be predictable with your copy, not creative with it.

What it can do is make localization visible: one version per market, typography driven by data, output you can inspect per locale. The alternative is a spreadsheet of translations and a designer clicking through fourteen languages the night before launch.

FAQ

Do we need a separate template for every language?

No. One template with per-locale value sets works while the composition stays the same. Add a version per locale when direction, typographic scale or imagery structurally differ.

How do we handle text expansion in generated images?

Measure the longest translated string per input, reserve space for it plus a margin, and run a 40% pseudo-locale before the real translations arrive. Bind size and line height as numbers so each locale adjusts without a redesign.

Can Arabic and Hebrew be rendered automatically?

The bidi algorithm orders characters correctly, but layout mirroring is a design decision. Produce a mirrored version, test mixed numeral strings, and have a native speaker review the render.

Where do fonts live in JsonCut?

Fonts upload as media in WOFF2, WOFF, TTF or OTF format. Keeping them in the workspace library makes them available across projects.

Sources

https://jsoncut.com/docs/media/ — JsonCut media uploads: font formats, retention modes, workspace library — accessed 2026-11-21.

https://jsoncut.com/docs/create/variables-and-templates/ — typed inputs, bindable typography properties, version pinning — accessed 2026-11-21.

https://jsoncut.com/docs/templates/ — bulk rendering: rows per plan, CSV limits, per-row validation, immutable template versions — accessed 2026-11-21.

https://www.unicode.org/reports/tr9/ — Unicode Standard Annex #9, Unicode Bidirectional Algorithm (Unicode 18.0.0, 2026-09-01) — accessed 2026-11-21.

https://simplelocalize.io/blog/posts/text-expansion-ui-localization/ — text expansion ranges per language and the "twice the English length" guideline — accessed 2026-11-21.

Your next post is one sentence away.Start free, no editing skills needed.