Check your pages list before you do anything else. A publish that times out has often completed anyway: Atlas stopped waiting for a response, but Shopify carried on and finished the job. Republishing without checking is harmless but wastes time, and it makes it harder to tell what actually happened.
In this article:
Step 1: Check whether it actually published
The messages you may have seen are Publishing timed out. You can try again., Publishing is taking longer than expected. Check your pages in a moment., or Import job not found. Please try again.
The second one says it outright. Give it a minute, then:
Open your Atlas dashboard and find the page in the content table.
Look at its status badge.
Publishedmeans it went through.Open your storefront and check the product page directly.
If the page is live, you are done. Nothing further is needed, and the timeout was only Atlas losing patience with a slow response.
ℹ️ If it did publish, it has already counted once towards your published pages allowance. Republishing the same page never counts a second time, so there is no billing risk in trying again.
Step 2: Try again
If the page is still a draft, publish it again. Most timeouts are caused by a temporarily slow response from Shopify, and a second attempt usually succeeds.
Wait a minute or two first. Retrying immediately into a store that is already struggling tends to time out again.
Step 3: Rule out the block limit
If the retry fails with Your theme has reached Shopify's 300-block limit., that is a different problem with a different fix, and no amount of retrying will help. See "Your theme has reached Shopify's 300-block limit".
Step 4: Publish fewer pages at once
Publishing a full store means writing a home page and every product page into the theme in one operation. That is much slower than publishing a single page, and much more likely to time out.
If a full store publish keeps timing out:
Publish the home page on its own.
Publish the product pages in small groups.
The result is the same, and each smaller operation is far more likely to complete.
Why publishing can be slow
Publishing is not one action. Atlas uploads the template files, creates the theme sections, publishes the page, and finalises. Each step involves your Shopify store.
Things that make it slower:
Factor | Effect |
A large theme with many templates and sections | Every write takes longer |
Publishing many pages in one operation | Multiplies the work |
Other apps writing to your theme at the same time | Contention |
A store under heavy traffic | Slower responses from Shopify |
💡 If you are publishing a lot at once, do it outside your busiest hours. A publish during a traffic spike or a sale is the most likely one to time out.
If it never succeeds
If a page will not publish after several attempts across more than one session, start a chat from the bubble in the bottom right of Atlas, or email support@helloatlas.io, and include:
your store URL
the name of the page and the theme you are publishing into
the exact error text
roughly when you tried, including the time zone
Say explicitly that you have already checked whether the page published anyway. That is the first thing support will check, and telling them saves a round trip.