Theme limits
Themes are subject to platform limits that control how many templates, sections, and blocks a theme can contain, and how large its files can be. This page consolidates those limits in one place. Individual limits are also documented on the relevant architecture pages, which are linked throughout.
Attempting to exceed a limit results in an error, either in the theme editor or when the theme is saved, uploaded, or synced with the Shopify CLI.
Anchor to TemplatesTemplates
| Limit | Value |
|---|---|
| JSON templates per theme | 1,000 |
| Sections per JSON template | 25 |
Anchor to Section groupsSection groups
| Limit | Value |
|---|---|
| Section groups per theme | 20 |
| Sections per section group | 25 |
Anchor to Sections and blocksSections and blocks
For more information about how sections and blocks are structured, refer to Sections and Blocks.
| Limit | Value |
|---|---|
| Blocks per section | 50 (you can reduce this limit with max_blocks) |
| Blocks per JSON template or section group | 1,250 |
| Theme block nesting depth | 8 levels, excluding the section level |
Theme block files (blocks/ folder) per theme | 300 |
The per-section and per-template block limits apply to blocks that merchants can add, remove, or reorder, including app blocks and theme blocks. Statically rendered blocks added with {% content_for %} don't count toward these limits.
Anchor to File and content size limitsFile and content size limits
The following limits apply to individual files within a theme:
| File | Maximum size |
|---|---|
| JSON template file | 512 KB |
| Section group file | 512 KB |
settings_schema.json | 512 KB |
settings_data.json | 1.5 MB |
| Locale files | 1.5 MB |
| Other Liquid files (sections, snippets, layouts) | 256 KB |
Content in a single liquid setting | 50 KB |
The following limits apply to a theme as a whole:
| Limit | Value |
|---|---|
| Uploaded theme package (compressed) | 50 MB |
| Total code (all files except assets) | 250 MB |
| Files per theme | 100,000 |
Anchor to NamingNaming
| Limit | Value |
|---|---|
| Theme name | 50 characters |
Section and block schema name attribute | 25 characters |
| Custom section and block names (set by merchants in the theme editor) | 100 characters |
Anchor to Theme app extensionsTheme app extensions
Apps that extend themes through theme app extensions have their own separate file and content size limits. Refer to Theme app extension configuration for details.