Shopify storefront guide
What Is Inside a Shopify Theme ZIP?
Learn how Shopify theme layouts, JSON templates, Liquid sections, snippets, settings, and assets fit together in an exported theme.
8 min read · TendeAI
A Shopify theme is a set of connected files
A theme ZIP packages the files Shopify uses to render and customize an online storefront. The folders have different jobs: layouts provide shared page structure, templates select page content, sections create reusable editor modules, and assets hold supporting files.
Shopify’s current theme architecture documentation describes the full set of supported folders and file types. A theme does not need every possible folder, but it does need a valid `layout/theme.liquid` file to be uploaded.
Common folders and their roles
layout/ — shared Liquid layouts, including `theme.liquid`, which wraps rendered pages.
templates/ — page-type templates. JSON templates compose a page from sections; for example, `index.json`, `product.json`, and `collection.json`.
sections/ — reusable Liquid modules that can expose settings and blocks in Shopify’s theme editor.
snippets/ — smaller reusable Liquid fragments rendered by layouts, sections, and other snippets.
assets/ — theme assets such as CSS, JavaScript, fonts, and images.
config/ — global theme settings definitions and saved settings data.
locales/ — storefront and theme-editor translation strings.
How a JSON template uses a section
A JSON template references section types by filename and sets their order. The Liquid file for each referenced section defines its markup and, when needed, a schema for merchant-editable settings.
{
"sections": {
"main": {
"type": "hero",
"settings": {
"heading": "Made for everyday rituals"
}
}
},
"order": ["main"]
}This points to a section file such as `sections/hero.liquid`. A section schema describes its settings and blocks so merchants can edit the content in Shopify’s visual theme editor. The example is illustrative; your section schema must define every setting referenced by the template.
Review a theme before publishing
- Extract the ZIP and confirm the theme folders are at the archive root, rather than nested inside an extra folder.
- Check that `layout/theme.liquid` exists and that JSON templates reference section files that are present.
- Review `config/settings_schema.json` and section schemas for valid JSON and usable editor settings.
- Run
shopify theme checkwhen you have Shopify CLI installed, and address the reported Liquid and theme issues. - Upload the theme as an unpublished theme, preview with your real catalog, and test mobile layouts and key shopping flows.
For the authoritative details, see Shopify’s theme architecture, sections, templates, and Theme Check guides.
Getting a theme ready to upload
TendeAI’s export workflow is intended to produce Shopify theme files from a storefront project. Review the app’s theme-generation features and upload instructions for the current workflow and plan requirements.