Theme packages: download, upload, and publish
Move a Lulu theme package into a draft and publish after review.
On this page
Use a Lulu export, not a generic Shopify Liquid ZIP. Review paid-theme licensing before publishing.
Download a working copy
Open Online Store → Themes, open the theme’s actions menu, and choose Download theme file. Keep the ZIP unchanged as a backup.
- The package contains a canonical shopwise-theme.json file.
Import a package
In Themes choose Import and select the upload option. Upload the Lulu ZIP or shopwise-theme.json file, within the 5 MB limit.
- The importer reads shopwise-theme.json and the copies of the same data in the ZIP: config/settings_data.json, templates/*.json (including alternate templates such as page.contact.json), config/groups.json and assets/custom.css.
- A copy you edited is used in place of the matching part of shopwise-theme.json. A copy you didn't touch changes nothing. If you change the same part in both places, shopwise-theme.json wins. After the import, a note on the Themes page lists the files whose edits were used and anything that was left out, such as unknown section types, settings or presetKey.
- sections/*.json, the README files, assets/custom.js and snippets/head-snippets.html are never read back. Change custom JavaScript and head snippets in shopwise-theme.json (codeFiles).
- Packages downloaded before 9 October 2026 have no file fingerprints, so only shopwise-theme.json is used. Download the theme again before editing the separate files.
Inspect the draft
Open the imported draft in the editor. Review its media references, menus, product selections, templates, and code.
- A package carries links to images, not the image files. Images uploaded to another store only show on that store, so upload them in this store and choose them again in the editor. Images on a public https:// address show everywhere.
- Theme import does not import your complete product catalog or orders.
Publish after testing
Use the theme’s Publish action after checking the draft. Complete any required paid-theme purchase shown by the interface.
- Confirm the live theme name afterward.
- Keep the previous theme available if you need to switch back.
CHECK YOUR WORK
You’re ready when…
- The imported draft matches the intended design.
- Referenced content exists in the target store.
- The intended theme is marked live after publishing.
IF SOMETHING DOESN’T LOOK RIGHT
Troubleshooting
Why is a Shopify ZIP rejected?
Lulu requires its own canonical shopwise-theme.json package data. A plain Liquid theme export is not a supported import; ask support about adapting the design.
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.
