Skip to main content

Why did my build fail?

What each Generation failed message in Atlas Web means and what to do, why a build shows Not started or You’re out of credits, and how the credits of a failed build come back.

Written by Grace

When a build stops, the Store Builder shows “Generation failed” with a message saying why, and Try again and Back to Home. Try again starts the build afresh. A failed build costs nothing: its credits come back on their own. If the page shows “You’re out of credits” instead, the build never started, because you didn't have enough credits.

In this article:


What happens to a failed build

  • The top bar shows Failed, and so does the page in Pages, in red.

  • Its credits come back automatically. In Settings → Billing & credits, Usage history shows the build as Build · Refunded.

  • Try again starts a new build with the same product, template and language, which uses credits again: 3 for a store, 2 for a product page or 1 for a pre-sell page. The failed build's credits still come back.

  • Back to Home takes you to Home, where you can start again with something else.

A failed build has no page to open: in Pages, Continue editing on a failed store or product page shows “This build didn’t finish, so there’s no page to open.” You can delete it.

[Screenshot: The Store Builder with the Generation failed notice over the canvas, showing a message and the Try again and Back to Home buttons]


If a store or product page build fails

Message

Why

What to do

“Couldn’t start the build.”

Something stopped the build from starting.

Click Try again.

“Too many requests. Try again in a few minutes.”

You've started a lot of builds in a short time: Atlas allows up to 30 builds an hour.

Wait a few minutes, then click Try again.

“Your store isn’t connected any more. Connect it again to keep building.”

The store you were building for was disconnected.

Connect the store again. A build already under way keeps going: look for it in Pages. See How to connect your Shopify store.

“Your session ended. Sign in again to keep building.”

You were signed out of Atlas.

Sign in. A build already under way keeps going: look for it in Pages.

“This build can’t be found any more.”

Atlas can't find this build.

Check Pages. If it isn't there, start the build again from Home.

“Couldn’t open the finished page.”

The page was built, but couldn't be shown.

Click Try again. It opens the finished page again without building it again, so it uses no credits.

“The build stopped before it finished.”

The build stopped without a reason.

Click Try again.

“Store generation is not available right now. Please try again later.”

Atlas can't build this page right now.

Try again later. If it keeps happening, contact support.

“This generation request is not supported. Please retry from the wizard.”

Atlas couldn't build this kind of request.

Go back to Home and start the build again. If you see it again, contact support.

A message ending in “Error ID:” and a number

Something went wrong while Atlas prepared the page, and Atlas recorded the details under that number.

Contact support with the message and the number.

Any other message

Something went wrong while the page was written.

Click Try again once. If the same message comes back, contact support with it.


If a pre-sell page build fails

Message

Why

What to do

“Your page stopped before it was written.”

Atlas stopped writing the page.

Click Try again.

“Atlas couldn’t read that product link. Paste it again, or pick a product from your store.”

Atlas couldn't read the product link the page is about. Nothing was charged.

Start again from Home with the link pasted again, or pick a product from your store. See How to build a page from a product link.

“Your store isn’t connected any more. Connect it again to build.”

The page is about one of your store's products, and no store is connected.

Connect the store again, then start again.

“Too many requests. Try again in a few minutes.”

You've started a lot of builds in a short time: Atlas allows up to 30 builds an hour.

Wait a few minutes, then click Try again.

“Couldn’t start your page. Try again.”

Atlas couldn't start writing the page.

Click Try again.

A pre-sell page you open again from Pages after it failed offers only Back to Home: start it again from Home.


If the build didn't start: You’re out of credits

A build uses 3 credits for a store, 2 for a product page and 1 for a pre-sell page. If you have fewer, the build doesn't start: the top bar shows Not started, the Atlas Agent panel shows “This build didn’t start. The page says why, and what to do next.”, and the page shows “You’re out of credits” with, for example, “A build uses 2 credits and you have 0. Your work is safe.” “You’re out of credits” then opens by itself, with plans to start or move up to, and Just top up credits for a credit pack; to open it again, click See plans. If your plan is still in its trial, you see “Your trial credits are used up. Start your plan now to keep building.” with Start plan now instead.

Once your credits are in, the page shows “Ready to build” and Build. The build doesn't start by itself, even after a reload: click Build. See How credits work.

While Atlas checks your credits you see “Checking your credits…”. If it can't, you see “Couldn’t load your credits”, with Try again.


If it still fails

If the same build keeps failing with the same message, contact support with the message, the product and the template. In the meantime you can build with another template or product. A build that keeps failing costs you nothing, since each failed build's credits come back.

If it still isn’t working, open the menu from your profile at the bottom of the sidebar and choose Chat with support, or email support@helloatlas.io.

Did this answer your question?