Partners: build a theme in a dev store and export it
Use the standard theme editor in a sandbox store, then download the package you submit.
On this page
You need a dev store. There is no separate partner theme tool — you build in the same editor merchants use. Start from a free theme: a paid Theme Store theme stays a trial on a partner store, so its code is read-only and it can't be published.
Open the theme
In the dev store admin open Online Store. The live theme is at the top; the rest are under Draft themes. Choose Edit theme on a draft, or Customize on the live theme.
- Work on a draft while you build, so the storefront preview stays stable.
Build the theme
Add, reorder and configure sections and blocks in the left-hand tree, and set theme settings. Save when the preview is right.
- Custom code lives under the theme's “…” menu → Edit code: custom CSS, custom JavaScript up to 100,000 characters, and head snippets up to 20,000 characters.
- Test the storefront itself, not only the editor preview.
Download the theme file
Return to Online Store, open the “…” menu on the theme and choose Download theme file. You receive theme_export__<store>__<theme>__<date>.zip.
- Keep the download: a published theme package has no stored release history and no rollback.
Know what is inside the package
shopwise-theme.json at the root of the zip is the main file Lulu reads back. config/settings_data.json, templates/*.json, config/groups.json and assets/custom.css are copies of the same data that you can edit instead; sections/*.json, the READMEs, assets/custom.js and snippets/head-snippets.html are for reading only.
- An edited copy is used in place of the matching part of shopwise-theme.json; an untouched copy changes nothing. Change one part in one place only: if both changed, shopwise-theme.json wins. The upload lists the files it used and warns you about anything left out.
- The full file format is in “Theme package format reference”.
- A Shopify Liquid theme export is not a Lulu package and is refused on import with a message that says so.
- The import limit is 5 MB.
CHECK YOUR WORK
You’re ready when…
- The theme renders correctly on the dev store's storefront.
- You have the exported zip, or you know which dev-store theme to snapshot.
IF SOMETHING DOESN’T LOOK RIGHT
Troubleshooting
Can I submit a Liquid theme from another platform?
No. Lulu imports its own export format, identified by shopwise-theme.json. A Liquid archive is rejected with a specific message rather than partly imported.
Why is a control missing or unavailable?
Confirm that you are in the correct store and that your role allows this action. Optional apps and channels may require installation, a plan, or activation. Share the screen name and error with support if access is still unclear.

