All platforms · 6 min · Upstream checked July 17, 2026

Export and import a Codex theme recipe

Move color, crop, surface, and readability settings without embedding a private wallpaper.

Platform behavior can change. Compare this guide with the original repository at commit 26c6c410e0e0.
01Finalize settings
02Download recipe v2
03Inspect the JSON
04Import and choose the image separately

What recipe v2 records

The recipe stores the source theme, name, colors, Fit or Fill mode, crop position, image adjustments, sidebar/card/composer opacity, borders, radius, shadow, and text brightness. It includes a generation timestamp and site identifier. It does not contain image bytes, scripts, commands, or credentials.

Import is strict by design

The Builder accepts small JSON files with the exact v2 format and validates required colors, numeric settings, and image-fit mode. Unknown or malformed files are rejected instead of being guessed into a partial theme. Choose the wallpaper separately because the original image never leaves its owner’s browser.

Use share links for settings-only collaboration

A share link encodes the same settings in the URL. Review the destination before sharing: a long URL is data, not a server upload. If the visual depends on a custom image, send that asset through a channel where you have the necessary rights and privacy approval.

A recipe is not an installer and does not prove compatibility with a particular Codex version.

Completion checklist

Related guides