How it works
Open the add-content menu
In the Migma create/chat input, click the ”+” (plus) button to open the add-content dropdown.
Two ways to import
Exact conversion keeps your email as-is and makes it Migma-editable and email-safe. Nothing about the design changes. Use this when the template is already the way you want it and you only need it inside Migma.What happens under the hood
This is not a model guessing at your markup. A deterministic converter parses your HTML and rebuilds it as editable Migma email source. That single detail is what makes the import dependable:Deterministic
A parser reads your HTML and maps it to Migma email source. The same input produces the same output every time, no model variance.
One engine
Every import compiles through the same engine that powers emails built from scratch in Migma, so the result is held to the same standard.
Email-safe output
The engine emits email-safe HTML for Gmail, Outlook, Apple Mail, mobile clients, and dark mode review.
color-scheme metadata). So if your original template renders fine in some clients but falls apart in Outlook, re-importing it through Migma is the fix: it comes back out as clean, email-safe HTML.
Tangled, inline-everything legacy markup becomes editable Migma email source
Quirks that break specific clients are normalized by the engine
The result is fully editable, not a flattened snapshot
Fixing a broken legacy template
This is the most common reason teams reach for HTML import. The workflow:Import the broken template
Paste or upload the HTML that’s misbehaving in Outlook (or anywhere else).
After import
Once your email is in Migma, it behaves exactly like one you built from scratch:
Refine in chat
Ask for changes in plain language: “make the headline larger”, “swap the hero image”, “tighten the footer spacing”.
Edit visually
Click into any block to adjust text, images, colors, and layout directly.
Run Preflight
Test the imported email across major clients and devices before it goes out.
Export anywhere
Export clean, email-safe HTML for any ESP. No vendor lock-in.
HTML import vs other methods
| HTML to Email | Figma to Email | Clone from Image | Claude Design | |
|---|---|---|---|---|
| Source | Existing HTML / .html / .eml | Figma file | Screenshot / mockup | React / JSX .zip |
| Method | Deterministic converter | Design analysis | Vision + OCR | Deterministic converter |
| Speed | Near-instant | 60-90 sec | 30-60 sec | Fast |
| Text | Carried over exactly | Exact | OCR-based | Carried over from design |
| Best for | Migrating & fixing existing templates | Original Figma designs | Emails you can only see | Emails designed in Claude |
| Setup | The HTML source | Figma file access | None | Export the .zip |
Troubleshooting
My paste didn't import
My paste didn't import
Cause: Partial markup, such as a copied fragment rather than a full document.Solution: Paste the complete HTML, or save the email as a
.html / .eml file and upload that instead.Fonts look different after import
Fonts look different after import
Cause: The original used a font that isn’t available across email clients.Solution: Migma maps to email-safe fallbacks automatically. To pin a specific one, ask in chat:
It looked fine before but rendered differently
It looked fine before but rendered differently
Cause: The original relied on CSS that some inboxes ignore. The engine rewrites those parts to email-safe equivalents.Solution: This is expected. The import is optimized to render reliably across clients. Confirm the result in Email Preflight, then refine anything you want to adjust.
Images are missing
Images are missing
Cause: The HTML referenced images by relative path or from a source that’s no longer reachable.Solution: Use absolute, publicly reachable image URLs in your source, or re-add the images in the visual editor after import.
Related
Figma to Email
Import directly from a Figma design file.
Clone from Image
Recreate an email from a screenshot or mockup.
Client Compatibility
How Migma keeps emails rendering reliably across inboxes.
Email Preflight
Test your imported email across major clients and devices.
Export Options
Export clean, email-safe HTML for any ESP.
Claude Design to Email
Import a design built in Claude’s design tool via React / JSX.