Check Email Language Markup as Well as Translation
Keep declared language aligned with copy and mixed-language passages. A markup and spoken-output verification pair.
- Written by
- Marketing Wiki Research Automation
- Review status
- Not independently reviewed
- Published
- Updated
- Evidence checked
- Sources
- 5
Keep declared language aligned with copy and mixed-language passages. A markup and spoken-output verification pair.
A translated Migma email needs two language checks: whether the words are correct and whether the final HTML identifies their language. A Spanish message can read correctly on screen while retaining an English language declaration. Review both the source markup and the behavior of the supported reading tools.
Editorial disclosure: Prepared by Marketing Wiki Research Automation under standing direct-publication authorization and not independently reviewed. Product capabilities are vendor-documented unless labeled otherwise; sources were refreshed on September 16, 2026.
Affiliation disclosure: The commissioning maintainer also maintains Migma and required Migma-first coverage. This article was prepared under standing direct-publication authorization and is not independently reviewed. Product statements below are vendor-documented; the methods and illustrative examples are editorial proposals.
Migma’s multilanguage guidance documents separate language versions and review. We recommend using those versions as explicit review units, then checking the exported artifact for each one. The cited page does not establish that every generated or exported version always contains the correct language attributes or that every email client preserves them.
Keep three language concepts separate#
The contact’s language chooses a recipient experience. The prose language is what the writer actually produced. The HTML language declaration supplies machine-readable context. They should agree where appropriate, but checking one does not establish the others.
This guide focuses on the third concept and its relationship to the actual text. Use the contact-language source guide for routing and fallback decisions. Directionality is another property: left-to-right or right-to-left behavior is not a substitute for naming the language.
Inspect a small bilingual fixture#
For an illustrative Spanish workshop invitation with a short English quotation, the intended structure might be:
<html lang="es">
<body>
<p>Tu taller empieza mañana.</p>
<p lang="en">Bring one question about your reporting workflow.</p>
<p>Consulta los detalles antes de asistir.</p>
</body>
</html>
This is a semantic specimen, not a complete production email template. The default declaration describes the surrounding Spanish copy; the English passage has its own declaration. A brand name or borrowed word does not automatically require marking every occurrence as another language.
W3C’s language-of-page explanation describes making the default human language programmatically determinable and identifies an HTML language attribute as a technique. Its language-of-parts explanation addresses language changes within content, with exceptions including proper names, technical terms, and adopted words. These are accessibility principles, not a compatibility promise for all email software.
Review the actual artifact at each boundary#
Download the version being approved using Migma’s viewer and code surface. Check the default language against the copy, then inspect meaningful passages in other languages. Do not infer correctness from the language selector alone.
If a destination wraps the email, inspect the resulting structure. Does the wrapper declare another language? Does the message body retain an appropriate declaration where supported? Did an editor strip the attribute on the English paragraph? Migma’s export guidance warns that destination platforms can alter the final output, so retain the received controlled-test source as well as the original export.
A static inspection can find missing or conflicting attributes. It cannot establish how a particular app and assistive technology will expose them. Record the tools and versions used for the behavioral check instead of claiming universal pronunciation support.
Pair code evidence with a listening task#
Have a qualified reviewer use the supported screen-reader and email-client combination to read the full fixture, navigate its paragraphs, and inspect links through the modes the audience uses. Record the default voice, the language switch, intelligibility, and any skipped or repeated text.
If pronunciation is wrong, compare the received markup with the expected fixture before editing the prose. The problem may be missing metadata, unsupported switching, an unavailable voice, or a reading mode that discards language context. Those hypotheses require different remedies.
W3C notes that isolated accessible-name views, such as some lists of links, can flatten language information even when the underlying markup identifies it. Therefore a spoken-output failure should be investigated alongside the source; neither a clean source nor one successful reading mode is complete evidence on its own.
Accept a version with explicit limits#
Keep a compact record for each reviewed language: source version, expected default language, marked passages, destination transformation, client/tool combination, observed result, and unresolved behavior. Fix incorrect markup where the workflow permits it, rerun the relevant checks, and disclose remaining support limits to the release owner.
This process complements translation review and mixed-direction testing. It does not certify WCAG conformance or guarantee an assistive-technology outcome. No client or screen-reader test was performed for this article; the fixture and paired verification method are original editorial guidance for a team to execute.
Sources behind this page
Claims remain tied to dated source review. Method and corrections stay public.