Skip to main content

Can I add custom code to pages Atlas builds?

Yes. Atlas pages become normal theme templates, so you can edit them in the Shopify theme editor, but republishing from Atlas will replace your changes.

Written by Eddie Lavandera

Yes. A page Atlas publishes becomes a normal template in your Shopify theme, so you can open it in the theme editor, add sections, and edit the code the same way you would any other page. The one rule to understand: republishing from Atlas replaces the page, including anything you changed by hand.

In this article:


What you can do

Once published, an Atlas page is a theme template. In the Shopify theme editor you can:

  • Add your theme's own sections above or below the Atlas content

  • Add app blocks from other apps

  • Edit the template's code, if you are comfortable doing so

  • Add custom CSS through your theme's settings or a custom Liquid section

This is deliberate. Atlas builds pages from real sections and blocks rather than a closed embed, which is what makes them editable afterwards.


The republishing rule

⚠️ Selecting Publish again on a page in Atlas rewrites that page in your theme. Anything you edited by hand in the Shopify theme editor is replaced. There is no merge and no warning listing what will be lost.

Publishing replaces the current home page and product pages with the same products on the selected theme.

This is not a reason to avoid custom code. It is a reason to decide where each change belongs.


Deciding where to make a change

Change

Make it in

Copy, headings, benefits, testimonials

Atlas editor

Colours, palette, section visibility

Atlas editor

Adding or reordering blocks within Atlas sections

Atlas editor

Adding a section from your theme

Shopify theme editor

Adding another app's block

Shopify theme editor

Custom CSS or scripts

Shopify theme editor, or theme settings

💡 Keep everything Atlas can do in Atlas. Then a republish only ever costs you the theme-editor changes, and you know exactly what those are. Mixing copy edits across both places is what makes republishing painful.


Adding tracking and third-party scripts

Do not add these to individual Atlas pages. Add them once, store-wide, so they survive any republish:

  • Analytics and pixels: use Shopify's Customer events settings

  • App scripts: use each app's own app embed in Theme settings

  • Site-wide CSS or JavaScript: your theme's settings or theme.liquid

Anything added at store level applies to Atlas pages automatically and is never touched by republishing.


What not to touch

The Atlas Page Builder app embed. Turning it off breaks every Atlas page on the theme.

The Atlas sections themselves, if you plan to keep editing that page in Atlas. Restructuring them by hand makes a future republish more disruptive.

The Atlas Bundler block's position, unless you mean to move it. It needs to stay on the product template for bundles to show.


If your changes disappeared

Almost certainly a republish. Either you selected Publish again, or someone else did.

There is no version history for theme edits inside Atlas. Shopify does keep some theme version history under Online Store, then Themes, then the theme's version history. Check there if you lost substantial work.

To avoid it recurring: keep custom code in a snippet or a section you add separately, rather than editing the Atlas-generated template directly. A separate section survives a republish; an edit inside the generated template does not.


Next steps

Did this answer your question?