HomeHow toJournalAbout
GitHubSay helloSay helloSay hello (contact)
Journal/Guides

Guides

Your Pasted Sections Can Survive a Shopify Theme Update

Shopify now carries code edits into the updated theme unless they clash with the developer's changes. Where you put your code decides which side of that line it lands on.

Published
12 October 2026
Reading time
6 min

On this page

  1. The rule changed in autumn 2025
  2. Two layers, two rules
  3. Where your code sits decides what happens to it
  4. How to update without surprises
  5. When an edit doesn't make it
All posts

When a theme update appears in your admin, most of the advice you'll find says the same thing: an update replaces your code, so back everything up and paste it back in by hand. That was Shopify's own rule until autumn 2025. Today Shopify includes your code edits in the updated theme as long as they don't conflict with the developer's changes, and a section pasted into its own file should have nothing to conflict with.

Key takeaways0 / 4

Before you press Publish

The rule changed in autumn 2025

Until at least 18 September 2025, Shopify's help page told merchants that any code change meant "Your code changes won't be included in the updated version". By early October the same page said the opposite: code edits that don't conflict with the update are included, whether you made them or an installed app did. Many guides still tell you every update wipes your work.

Shopify also tells you which way it went. Once the updated theme lands in your draft themes, its card reads either "Theme added: code edits successfully included" or "Theme added: code edits could not be included". It is the first thing to read after an update, although "included" only means the code merged (more on that below).

A theme card for Updated copy of Horizon, version 2.1.6, with a green message: Theme added: code edits successfully included
Source: Shopify Help Center

Two layers, two rules

A Shopify theme holds your store's design in two places, and an update treats them differently.

Everything you change in the theme editor sits in the first layer: theme settings, which sections appear on which page and in what order, each section's images, text and colours, new templates, app embeds and wording changed in the content editor. All of it is copied into the updated theme.

The second layer is code: anything you or an app changed in the code editor, with the exception of the Templates folder and settings_data.json, which belong to the first layer; this is the layer that can conflict.

Where your code sits decides what happens to it

When Shopify can't merge an edit, it lists the files it gave up on – in one merchant's case from May 2026, the theme's header, footer, contact form and seven more of its own sections. A clash means both sides changed the same part of the same file. When that happens, the developer's version wins and your change is left behind.

A section pasted as a new file sits outside that collision. A PROPS section, for example, is one file called something like props-faq-rows.liquid that you add next to the theme's own sections. The developer never ships, edits or removes a file by that name, so the update has nothing to compare it against and should copy it in, unless a future version of the theme adds a file with the same name. A developer who updated a store from Impact 4 to Impact 7 in April 2026 saw exactly that: the section files the store had added came across and kept working, while edits inside theme.liquid, theme.css and the theme's JavaScript were lost because the new version had rewritten those files.

A search for ss- in the Impact 4 theme's files, listing section files the store had added, such as ss-trust-badges-pro.liquid and ss-gallery-9.liquid
Source: Ed Codes

Edits typed into the theme's own files are the ones at risk, and only when the developer happens to change the same part: a tracking script pasted into theme.liquid, a tweak to header.liquid, a block of CSS added to the end of the theme's stylesheet. If you have a choice, put new work in a new file, and an update becomes something to review rather than something to rebuild.

A Google Tag Manager script pasted into the head of theme.liquid in the Impact 4 theme
Source: Ed Codes
Note

Not every theme gets updates

Only themes installed from the Shopify Theme Store receive them. A theme bought from a designer's own site, a Theme Store theme uploaded to a second store and the vintage themes Shopify has retired don't, so for those this question never comes up.

How to update without surprises

An update can't break your live store on its own, although publishing it unchecked can. If you have edited any theme file, Shopify won't update the theme in place; it installs the new version as an unpublished copy named "Updated copy of" your theme, and your store keeps running on the old one until you press Publish.

The live Horizon theme in the Shopify admin showing Version 2.1.6 available, with a dialog that offers Add to theme library and View release notes
Source: Shopify Help Center
  1. Keep a way back. Duplicate your live theme before you start, and save a copy of any code you've customised, as Shopify advises. A store holds at most 20 themes, so you may need to delete an old draft first.
  2. Add the update to your draft themes. In Online Store, the notice sits where your theme's version number usually is. Open it, read the release notes, then choose Add to draft themes. Some updates take several minutes.
  3. Read the card. "Code edits successfully included" means your pasted sections came across. "Could not be included" means at least one edit didn't: look at the files it names, and open the new copy's code (⋯ > Edit code > Sections) to see whether your section files are there.
  4. Open every page that uses a pasted section with the card's Review button. "Included" means the code was merged, not that it still looks right next to a redesigned header, and placements are worth checking with your own eyes even though Shopify copies them.
  5. Check custom CSS. It can be carried over and still miss, because the selectors it targets may no longer exist in the new version.
  6. Publish, and keep the old theme in your theme library for a while, so you can switch back if you need to.
Tip

Pick a quiet week

Theme Store developers usually can't ship more than one update every four weeks, so waiting for a week when a broken page would cost you little won't leave you behind.

When an edit doesn't make it

If the card says your edits couldn't be included, nothing is lost: your published theme still has every one of them. For a section that lives in its own file, the fix is the same as installing it the first time: copy the file from the old theme, or from PROPS, into the new theme's sections folder, then place it on the page again. Edits inside files the developer rewrote are a different job, because your change has to be fitted into their new code; that is a job for a developer, and until it's done the old theme can stay published.

A theme card for Updated copy of Horizon, version 2.1.6, with a yellow warning: Theme added: code edits could not be included
Source: Shopify Help Center

How to add a PROPS section to your theme

Browse the PROPS sections

while you’re here

Keep reading

GuidesWhy Shopify Apps Leave Ghost Code in Your ThemeWhen you uninstall an app, Shopify immediately cuts its access tokens. That keeps store data safe, but it also traps leftover snippet code inside your theme files.16 Oct 20266 min
Shopify UpdatesShopify Summer 2026 Edition Brings 150 New Changes To The StoreFrom agentic storefronts to the end of Shopify Scripts, here is what the Summer 2026 means for merchants.18 Jun 202610 min

straight to your inbox

Hear about
the next one.

One email when something new lands. No spam, ever.

Explore

  • All sections
  • How to install
  • Journal

PROPS

  • About
  • Contact
  • Privacy
It’s all open source!
Meet the makers!

© 2026 PROPS. Free, open-source Shopify sections under the MIT licence.Made by House of Brilliant Ideas