> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecomwize.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Publishing Pages to Shopify

> Step-by-step guide to publishing your EcomWize landing pages to your Shopify store.

Publishing makes your EcomWize page live on your Shopify store. Your sections, brand styles, and content are all pushed to your Shopify theme automatically.

## Prerequisites

Before publishing, make sure you have:

* A connected Shopify store (see [Store Connection](/shopify/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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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](/shopify/template-types))

    You can access these settings via the settings icon in the Publish modal.
  </Step>

  <Step title="Click Publish">
    Click the **Publish** (or **Update** if re-publishing) button. A progress bar will appear tracking the publishing process.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## What Happens After Publishing

After successful publishing:

* The page status changes from **"draft"** to **"published"**
* The publish timestamp is recorded
* You receive a direct link to view your live page on Shopify

<Note>
  Re-publishing an already published page updates the existing page rather than creating a new one. Your live page is overwritten with the latest content.
</Note>

## Publish Progress Tracking

The Publish modal shows a progress bar during the publishing process.

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

<AccordionGroup>
  <Accordion title="Missing images error">
    **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.
  </Accordion>

  <Accordion title="No store connected">
    **Error:** "No 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.
  </Accordion>

  <Accordion title="Payment required">
    **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.
  </Accordion>

  <Accordion title="Publish limit reached">
    **Error related to published page count**

    Each 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.
  </Accordion>
</AccordionGroup>

## 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

<Tip>
  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.
</Tip>

<Warning>
  Do not delete or rename sections manually in the Shopify theme editor unless you know what you are doing. Manual changes in Shopify can cause conflicts during re-publishing.
</Warning>