Preparing for the new Theme Editor

Shopify Staff
Shopify Staff
13 0 13

We rebuilt the theme editor to make it faster and easier to use. The rebuilt theme editor has been rolling out to merchants as of September 2020.

The new theme editor doesn’t support theme objects with more than 250 sub-objects, such as sections with 250 or more blocks, or blocks with 250 or more settings. This means that you might need to review and edit some of your sections and blocks so you can upgrade to the new theme editor. Below are some steps you can follow to find objects that are not compatible, and best practices to ensure that you stay under the 250 object limit going forward.

Best practices for reducing the number of blocks and settings in your theme

Review your hidden sections

Hiding a section is a good way to edit your theme without making changes visible to your customer before you are ready. However, if you keep sections hidden that you don’t plan to use, then these hidden sections can accumulate and take up space in your theme.

Don’t use sections as spacers

Avoid using sections as separators or spacers, as each section contributes to your overall section limit. If you need more white space in your theme, then check whether your sections offer any options to increase white space, like the Top margin and Bottom margin settings in the Narrative theme. If your theme doesn’t have these options, then consider editing your theme CSS or contacting a Shopify expert to help you.





Reduce the number of grids in your store

Grids showing products, collections, or photos, such as product recommendations, lead to a large number of blocks and settings. You should curate the content in your grids so that they show only contextually relevant information to your customers.

How to find blocks or sections with 250+ settings

You might see messages in the new theme editor interface indicating that you have a section or block with over 250 settings. Below are some strategies that you can use to identify where you have large numbers of blocks or settings.

Blocks with more than 250 settings

Blocks are objects inside of a section, such as individual products or images. Some blocks contain multiple settings that control their appearance and functionality. You might not realize that you have blocks with many settings because the sections that contain the blocks are hidden by default in the Shopify theme editor and don’t need to be modified.

You might also have a block with more than 250 settings. This is often because your theme provides large blocks out of the box. For example, ArenaTheme produces themes with blocks that contain 269 settings.

Below is a list of themes we’ve identified that have this issue. Your theme might have this issue and not appear on this list.

  • Ss_AutoParts
  • Handy
  • Pipeline
  • Impulse
  • Electro
  • Ella
  • Wokiee
  • Debut
  • Turbo
  • Symmetry
  • Motion
  • Chromium
  • District
  • Retina
  • AutoStore V2

Reach out to your theme developer to check whether your theme has a block with more than 250 settings, or to Shopify support if you have a Shopify theme.

Sections with more than 250 blocks

Sections most likely to have more than 250 blocks are those which show a grid of products, collections or photos, for example product recommendations. We advise you to remove these sections, or at least some of the blocks inside these sections, in order to support the latest improvement to our theme editor.



Sections that have more than 250 settings

Some sections contain a large number of configurable settings. If a section has more than 250 available settings, then you need to remove the section or reduce the number of settings. If the setting is static, or you need to keep using the section in your online store, then you might need to work with your theme’s developer to make these changes.

One area where you may notice a large number of settings is headers (we’ve seen some with up to 536 settings). Please check the number of settings on your headers and remove any with more than 250 setting options.

If you have a question after reviewing this content please post a detailed message in the Shopify Design discussion board.