Skip to main content
Publishing transforms your EcomWize page into live Shopify theme assets. Each section is converted to Shopify Liquid code, and the page becomes accessible on your Shopify store.

​
Prerequisites

Before publishing, make sure you have:
  • A connected Shopify store (see Store Connection)
  • A Starter or Pro plan (the Free plan does not support publishing)
  • A page with at least one section
  • All image elements filled in (empty images will cause publish errors)

​
Publishing Step by Step

1

Open the Publish modal

In the builder, click the Publish button in the top toolbar. The Publish modal will open showing your page details and publishing options.
2

Select your store

Choose which connected Shopify store to publish to. If you only have one store connected, it will be pre-selected. The store dropdown shows all your connected stores.
3

Configure page settings

Before publishing, make sure your page settings are configured:
  • Page title — The title that appears on Shopify
  • Handle (URL slug) — The URL path for the page (e.g., landing-page becomes yourstore.com/pages/landing-page)
  • Meta description — SEO description for search engines
  • Template type — Page template or product template (see Template Types)
You can access these settings via the settings icon in the Publish modal.
4

Click Publish

Click the Publish (or Update if re-publishing) button. A progress bar will appear tracking the publishing process.
5

Wait for completion

The publish process takes 10-30 seconds depending on the number of sections. Do not close the modal while publishing is in progress.
6

View your published page

Once complete, a success message appears with a direct link to your published page on Shopify. Click the link to view your live page.

​
What Happens Behind the Scenes

When you click Publish, EcomWize performs several operations:

​
1. Liquid Code Generation

For each section on your page, the universal generator converts the React component and its configuration into Shopify Liquid code. This includes:
  • HTML markup matching the section layout
  • CSS styles with brand style variables
  • Responsive styles for mobile and desktop

​
2. CSS Variable Injection

Your brand style properties (colors, fonts, spacing, etc.) are converted to CSS custom properties and injected into the page’s stylesheet. This ensures consistent styling across all sections.

​
3. Font Loading

Google Fonts and any custom fonts used in your brand style are loaded via @font-face declarations and Google Fonts API links in the page template.

​
4. Theme Asset Creation

Each section is created as a Shopify theme section file. The section files are uploaded to your store’s active theme via the Shopify API.

​
5. Page/Template Creation

Depending on the template type:
  • Page template: A new Shopify page is created (or updated) with the generated template
  • Product template: A new product template is created that can be assigned to products

​
6. Status Update

After successful publishing:
  • The page status changes from “draft” to “published”
  • Shopify section IDs are stored in the database for future updates
  • The publish timestamp is recorded
Re-publishing an already published page performs an update rather than creating new assets. Existing Shopify section files are overwritten with the latest content.

​
Publish Progress Tracking

The Publish modal shows a progress bar during the publishing process. The progress reflects the completion of each step: code generation, asset upload, and page creation. If an error occurs during publishing, the progress bar stops and an error message is displayed with details about what went wrong.

​
Common Publish Errors

Error: “Some images are missing. Please make sure all images are filled in.”This occurs when one or more image elements in your sections have no image set (they still show the default placeholder). Shopify requires all image fields to have valid URLs.Fix: Go through each section and make sure every image element has an image uploaded or selected from the media library.
Error: “No active Shopify store found. Please connect a store first.”You need a connected Shopify store to publish. Go to the Stores page and connect a store, or make sure your existing store connection is active.
Error: “Payment required”This appears if your subscription payment has failed or if you are on the Free plan. Publishing requires an active Starter or Pro subscription.
Error related to published page countEach plan has a limit on the number of published pages:
  • Starter: Up to 10 published pages
  • Pro: Unlimited published pages
To publish more pages, either unpublish an existing page or upgrade your plan.

​
Re-Publishing Updates

After the initial publish, any changes you make in the builder are not automatically pushed to Shopify. To update your live page:
  1. Make your changes in the builder
  2. Open the Publish modal
  3. The modal will show “Update” instead of “Publish,” indicating this is a re-publish
  4. Click Update to push the latest changes to Shopify
The Publish modal shows when your page was last published (e.g., “Published 2 hours ago”) so you can tell whether your live page is up to date with your latest builder changes.
Do not delete or rename the Shopify theme sections manually in the Shopify theme editor unless you know what you are doing. EcomWize tracks section IDs to map updates correctly. Manual changes in Shopify can cause conflicts during re-publishing.