Why can't I add a section in the Shopify theme editor?
A section appears in the theme editor's Add section list only if that section's file contains a presets array in its schema. If it has no presets it can still render, and it can still be edited, but it can never be added, moved or removed from the editor. The second rule is placement: a section can name the pages or the header and footer areas it is allowed in, and the picker hides it everywhere else. Between them, those two rules explain almost every case where a section is plainly present in the theme and plainly absent from the picker.
We counted it rather than assuming. On 10 September 2026 we read every section file in 12 real Shopify themes from our own build archive, 295 files in total, and parsed each schema. 209 of them (70.8 percent) declare presets and are addable. 86 (29.2 percent) do not, and the same seven filenames account for almost all of them in every single theme. The tables below are that count.
Update, 20 October 2026. We ran the same count on Dawn, Shopify's own free theme, at version 16.0.0 (released 10 August 2026), because most merchants asking this question are on Dawn or a theme built from it. Dawn has 46 section files. 22 of them have presets, and 20 of those 22 restrict where they can be added. That second number is the reason a section can be in the picker on one page and missing on the next, and it has its own section below.
What decides whether a section shows up in Add section?
Shopify's own documentation is unambiguous about it: "Section and block files must define presets in their schema to support being added to JSON templates using the theme editor." Files without presets "should be included in the JSON file manually, and can't be removed using the theme editor."
So any section in your theme is in one of four states, and only the first two put it in the picker.
| State | What the file looks like | In the Add section list? | Can you move or delete it? |
|---|---|---|---|
| Addable | Schema has a presets array with at least one entry |
Yes | Yes, once added |
| Already placed | Addable, and already listed in the template's JSON file | Yes, and you can add a second copy | Yes |
| Static | Called by a section tag in layout/theme.liquid |
No | No. It shows in the sidebar, pinned |
| Template owned | No presets, listed by hand in templates/product.json or similar |
No | No. Settings only |
Nothing in the theme editor tells you which state a section is in. The picker just does not list it, and there is no message explaining the absence.
How many sections does my theme have that I have not used yet?
This is the most common answer by a distance, and it is the good one. The section is in the picker, you have simply never scrolled to it. Every theme we measured shipped more addable sections than its homepage was using, by a wide margin.
| Theme | Section files | Addable (has presets) | On the homepage today | Sitting unused in the picker |
|---|---|---|---|---|
| Halcyon (paid build) | 26 | 19 | 11 | 8 |
| Driftline (paid build) | 26 | 19 | 11 | 8 |
| Foldfathom (paid build) | 25 | 18 | 10 | 8 |
| Clean Minimal (free) | 23 | 16 | 6 | 10 |
| Editorial (free) | 23 | 16 | 6 | 10 |
| Wellness (free) | 23 | 16 | 6 | 10 |
Between 8 and 10 unused sections per theme. If you are looking for something like a testimonials strip, an FAQ block or a countdown, open Add section and read the entire list before concluding it is not there. The name in the picker comes from the preset's name field, not the filename, so a file called halcy-proof.liquid can appear as "Trust badges" and a file called halcy-gallery.liquid appears simply as "Gallery". Searching the picker for the filename finds nothing.
A newsletter signup is the thing people most often look for here and miss, because many themes keep it as a footer setting or a block rather than a section. Where it lives in Dawn, Horizon and themes without one is in how to add a Shopify newsletter signup form.
Why is a section in the list on one page and missing on another?
Because the section's schema says where it is allowed. Two optional fields do it: enabled_on lists the only page types or areas the section may go in, and disabled_on lists the ones it may not. The picker filters by both before it shows you anything, and it does not mention what it filtered out.
Dawn uses these rules on 20 of its 22 addable sections. Only Apps and Custom Liquid can go anywhere. This is what the Add section list offers in each part of a Dawn 16.0.0 store, counted from the theme's own files:
| Where you click Add section | Sections offered | Only offered here |
|---|---|---|
| Homepage, collection, cart and other pages | 18 | (none) |
| Product page | 20 | Disclosures, Quick order list |
| Password page | 19 | Email signup banner |
| Header area (above the page) | 3 | Announcement bar |
| Footer area (below the page) | 3 | (none; Email signup is offered here and on pages) |
Two rows in that table answer questions we see often. The section called Email signup banner is restricted to the password page, so on your homepage it simply does not exist; the one you want there is called Email signup. And the header and footer areas offer only 3 sections each, because 15 of Dawn's sections, including Image banner, Slideshow, Rich text and Featured collection, are switched off in both areas. If you are trying to put a banner image in the footer of a Dawn store, the theme has ruled it out, and no setting changes that.
To check a section yourself, open its file in the code editor and search for enabled_on and disabled_on. A line such as "enabled_on": { "templates": ["product"] } means product pages only. Shopify's documentation describes both fields, and notes that a section can use one or the other but not both.
Why can't I move or delete my header, footer or announcement bar?
Because they are not part of the page template, and the answer depends on which of two common builds your theme uses.
| Section | Dawn 16.0.0 (section groups) | Our 12 themes (static) |
|---|---|---|
| Header | Pinned. No presets, so it cannot be removed or added again | Pinned. Settings only |
| Footer | Pinned. No presets, so it cannot be removed or added again | Pinned. Settings only |
| Announcement bar | Removable. It has presets and can be re-added, but only in the header area | Pinned. Settings only |
| Other sections in that area | Header area takes 3 kinds, footer area takes 3 (see the table above) | None. Nothing else can be added there |
Dawn renders its header and footer as section groups, which are small lists of sections stored in sections/header-group.json and sections/footer-group.json. The editor shows each group as its own area with its own Add section button. Inside a group the usual presets rule applies, so the header and footer themselves stay put while the announcement bar can be deleted, and an Email signup section can be added below the footer.
The 12 themes we measured take the older route: the announcement bar, the header and the footer are each called by name from layout/theme.liquid. Shopify's rule for that is short: "Statically rendered sections can't be removed or reordered by merchants." They sit pinned in the editor sidebar, and clicking them gives you their settings and nothing else. That is by design rather than a permission problem or a bug in your theme.
You can tell which kind you have from the sidebar. If the header has its own Add section button directly beneath it, your theme uses section groups. If you only see the header and footer as single pinned rows, they are static. Either way, if you need a pinned announcement bar gone, look inside its settings for an enable checkbox, which most themes provide. Failing that it is a code edit to layout/theme.liquid, and code edits are replaced by the next theme update.
Why can't I remove the product section from my product page?
Same rule, different location. The main content section of each template is deliberately built without presets so it cannot be deleted, because a product page with no product section would be a broken page.
The seven files without presets were identical across 10 of the 12 themes we read:
main-productmain-collectionmain-blogmain-cartmain-searchmain-contactproduct-recommendations
The two remaining themes had eight, because their header file also carried no presets. You can still click any of these in the editor and change their settings. You cannot reorder them against the sections around them, and you cannot remove them.
Dawn follows the same pattern on a larger scale: 24 of its 46 section files have no presets. Most are the main- sections and small cart pieces, plus Header, Footer and Related products. That last one matters if you deleted related products from a product template by editing the JSON: with no presets it can never be put back through Add section, only by restoring the entry in templates/product.json.
If the product recommendations section is on the page but shows nothing, that is usually Shopify having no eligible products to recommend rather than a theme fault. Why related products are not showing on a Shopify product page covers the rules and the fix.
The section exists in the code but not in the editor. What do I add?
If you have opened the file and confirmed there is no presets block, adding one is four lines. It goes inside the schema object, after settings, and the minimum viable version is just a name:
"presets": [
{
"name": "Gallery"
}
]
}
That is copied verbatim from a working section in one of the themes we measured, and the closing brace there is the end of the schema object. Save the file, reload the theme editor, and the section appears in the picker under that name. Two cautions. Shopify advises that "Sections with presets shouldn't be statically rendered", so do not add presets to a section that layout/theme.liquid already calls by name, or you will end up able to place a second copy of your own header. And if you are editing a theme you bought, this change is overwritten the next time the developer ships an update.
The alternative, which survives updates, is to add the section to the template JSON by hand. In templates/index.json you add an entry under sections keyed by any unique id, then add that same id to the order array. A section listed in order renders. A section defined but left out of order does not, which is a quiet way to lose an hour.
Why is the Add section button greyed out or doing nothing?
Check how many sections that page already has. Shopify's documented ceiling: "JSON templates and section groups can render up to 25 sections, and each section can have up to 50 blocks." Hit 25 and the editor stops letting you add more.
For scale, across the 120 JSON templates in the 12 themes we read, the busiest single template held 11 sections. So the limit is real but generous, and if you are near it on a homepage the page is probably too long for a phone anyway.
The other common cause is the wrong template or the wrong area. Sections can declare enabled_on or disabled_on rules, so a section built for product pages will not offer itself on the homepage, and a section switched off for the footer will not appear when you click Add section under the footer. None of our 12 themes used those rules, which means every addable section in them is offered everywhere. Dawn uses them on 20 of 22 addable sections, as the table above shows.
Why can't I add my app's block to this section?
This one is not about presets and it catches a lot of people out. An app block can only be added to a section whose schema explicitly accepts one, by listing a block of type @app. No @app entry, no app block, regardless of what the app's install instructions say.
We checked our own themes and the result was blunt. Of the 295 section files, 106 supported blocks at all, and zero declared an @app block. On those themes an app that installs as an app block had nowhere to go, and the merchant saw an empty Apps tab in the block picker with no explanation. That was a gap in our themes rather than a fact about Shopify, and the symptom looks identical from the merchant's side either way.
Update, 10 September 2026. We fixed it the same day we measured it. Newly generated Themr themes declare @app on the product, collection, cart and article sections and render app blocks in place, and they ship an apps.liquid wrapper so an app added as its own section picks up the theme's width and spacing instead of Shopify's unstyled fallback. That is five app block slots per theme where there were none. A theme you downloaded before that date still has zero, and the fix is the one entry described here: a blocks array containing a single object whose type is @app, plus a loop in the section that renders it.
If you are evaluating a theme and you already know which apps you need on the page, this is worth checking before you commit. The full diagnosis, including the difference between an app block and an app embed and the two edits that fix a section, is here: why you can't add your app's block to your Shopify theme.
A five minute checklist
- Open Add section and read the whole list slowly. The label comes from the preset name, not the filename, so it may be called something you did not expect.
- Confirm you are on the right page in the editor. The template dropdown at the top centre says which one. Homepage sections and product page sections are different lists, and the header and footer areas have short lists of their own.
- If the section you want is one you have seen on another page, open its file and search for
enabled_onanddisabled_on. Those lines name the only places it is allowed. - Confirm you are editing the live theme. Online Store, then Themes, and check which one is labelled Live.
- Count the sections already on the page. At 25 the editor stops accepting more.
- If it is still missing, open the file at
sections/your-section.liquidin the code editor and search for the word presets. No match means the section can never appear in the picker, and that is the whole answer. - If it is a header, footer or a
main-anything, stop looking. Those are pinned on purpose and cannot be moved or deleted from the editor. An announcement bar is pinned too unless your theme uses section groups, as Dawn does.
Nothing above requires a support ticket or a developer, and none of it produces an error message, which is precisely why it eats an afternoon. If you want to see how a theme is put together before you install it, every theme in our free theme gallery has a live preview you can open. If what you are actually missing is a block rather than a section, the rules are different and are set out in the difference between a section and a block. Two related faults that also look like breakage and are not: a homepage that is blank after installing a theme, and colors that will not change when you edit the setting. If the theme will not install at all, that is usually a schema error in the ZIP.
Frequently asked questions
Why can't I add a section in the Shopify theme editor?
Because the section's file does not declare a presets array in its schema, and Shopify only lists a section in the Add section picker if it does. Shopify's documentation states it directly: section and block files must define presets in their schema to support being added to JSON templates using the theme editor. Across 12 real themes we read on 10 September 2026, 209 of 295 section files declared presets and 86 did not. A section without presets can still render and still be edited, it simply cannot be added, reordered or deleted from the editor.
My theme has a section file but the theme editor does not show it. Is the theme broken?
Almost certainly not. Open the file at sections/your-section.liquid and search for the word presets. If there is no match, the file is working exactly as written and was never meant to appear in the picker. The seven files that most often cause this confusion are main-product, main-collection, main-blog, main-cart, main-search, main-contact and product-recommendations, which were identical across 10 of the 12 themes we measured.
How do I make a Shopify section appear in the Add section list?
Add a presets array to the section's schema. The minimum version is a single object with a name field, placed inside the schema object after settings, for example a presets array containing one entry whose name is Gallery. Save the file, reload the theme editor, and the section appears under that name. Two cautions: do not add presets to a section that layout/theme.liquid already renders statically, because Shopify advises against it and you will be able to place a duplicate header, and any code edit to a purchased theme is overwritten by the next theme update.
Why can't I delete or move my header, footer or announcement bar?
Because they are not part of the page template. In Dawn 16.0.0 the header and footer live in section groups and have no presets, so they cannot be removed, but the announcement bar does have presets and can be deleted and re-added in the header area. In older style themes, including the 12 we measured, all three are rendered statically from layout/theme.liquid, and Shopify's rule is that statically rendered sections cannot be removed or reordered by merchants. They appear pinned in the editor sidebar with settings but no drag handle and no delete option. Look inside the section's own settings for an enable checkbox, which is how most themes let you switch off a pinned announcement bar.
How many sections can a Shopify page have?
25. Shopify's documented limit is that JSON templates and section groups can render up to 25 sections, and each section can have up to 50 blocks. If Add section stops responding, count what is already on the page. For scale, the busiest of the 120 JSON templates we read across 12 themes held 11 sections, so most stores are nowhere near the ceiling.
Why is the Apps tab empty when I try to add an app block to a section?
Because that section's schema does not list a block of type @app, and without that entry no app block can be placed there no matter what the app's instructions say. This is the theme's decision, not the app's. When we checked our own 295 section files on 10 September 2026, 106 supported blocks at all and zero declared an @app block. That was a gap in our own themes rather than one Shopify imposes, and we fixed it the same day: newly generated themes now declare @app on their product, collection, cart and article sections and ship an apps.liquid wrapper for app blocks added as their own section. If your theme predates that, the fix is one entry in the section schema, a blocks array containing a single object whose type is @app, plus a loop in the section that renders it.
Why does a section appear on one page of my store but not another?
Two reasons. Sections can declare enabled_on or disabled_on rules in their schema that restrict them to particular page types or to the header and footer areas, and the picker hides them everywhere else without saying so. Dawn 16.0.0 does this on 20 of its 22 addable sections: its homepage offers 18 sections, its product page 20, and its header and footer areas 3 each. And each template has its own separate section list, so adding a section to your homepage does nothing to your collection pages. Check the template dropdown at the top of the theme editor before concluding a section is missing, because you may be looking at the picker for a different page type.
Why can't I find the Email signup banner section on my Dawn homepage?
Because in Dawn 16.0.0 the Email signup banner section is restricted to the password page by an enabled_on rule in its schema, so the homepage picker never lists it. The section to use on the homepage is called Email signup, which Dawn allows on every page and in the footer area, though not in the header area. Both collect addresses into the same Shopify customer list.
What sections can I add to the footer in Dawn?
Three, counted from Dawn 16.0.0's own files: Email signup, Apps and Custom Liquid. The Footer section itself has no presets, so it cannot be removed or added a second time. Fifteen of Dawn's sections, including Image banner, Slideshow, Rich text and Featured collection, carry a disabled_on rule for both the header and footer areas, so they never appear when you click Add section there. The header area is similar: Announcement bar, Apps and Custom Liquid.
Generate a theme that looks like your brand
A complete Shopify 2.0 theme with conversion features built in, ready in minutes. No credit card required.
Generate my theme freeNo Shopify store yet? Start one here, then bring the theme. Themr may earn a commission if you start a paid plan; it does not change what you pay.