When a publish does not complete, Home shows a red banner such as One page did not publish, and the page's row on Pages gets the Publish failed badge. The page is not on your storefront in its new form until it publishes.
See Why
- Go to Pages. Use the Status filter if you have many pages.
- Find the row with Publish failed.
- Read the banner under it, This page did not publish. It gives the reason and lists each problem the check found.
You can also click Review and publish in the editor. If the page cannot publish, it says This page cannot be published yet. with the reason.
Common Causes
| Message | What to do |
|---|---|
| The Free plan publishes 3 pages, and this shop has 3 live. | Unpublish a page or move to a bigger plan. See Plan Limits and Downgrades. |
| A message naming a reusable section already on an earlier page | On Free, each section can be on one page. Copy its content into this page, or upgrade. |
| The Free plan does not include Custom HTML. | Remove the Custom HTML element, or upgrade. |
| The page could not be compiled. Open it and check for an element the compiler refused. | Open the page and run Review and publish to find the element. |
| Not allowed — the app may be missing permission to publish for this shop. | Open Drip Pages from the Apps menu and accept any permission request Shopify shows. |
| A message after changing the page type | Some values or elements no longer fit the new type. Change them, or switch the type back. |
Publish Again
- Fix the cause.
- Click Publish on the row, then Publish to storefront? to confirm.
- Refresh Pages after a moment.
If It Still Fails
Use Settings → Contact support. To let support look at the page directly, turn on support access and describe the page in What are they helping with?