Directory structure

theme/
├── layout/            theme.liquid (required), password.liquid
├── templates/         index.json (required), product.json, product.<suffix>.json, …
│   ├── customers/     (accepted for Shopify themes; account pages are drawn by Sooquna)
│   └── metaobject/    <type>.json: pages for metaobject entries
├── sections/          *.liquid sections, and *.json section groups
├── blocks/            *.liquid theme blocks (_name.liquid for private blocks)
├── snippets/          *.liquid partials for {% render %}
├── custom_pages/      *.liquid standalone pages at /custom/<name>
├── assets/            CSS, JS, fonts, images, SVG
├── config/            settings_schema.json (required), settings_data.json
├── locales/           en.default.json, ar.json, *.schema.json
└── theme.json         name, version, author, supported locales

File names

Folder	Allowed names
layout/, snippets/	lowercase letters, digits, - and _, ending in .liquid
templates/	<type>.json or <type>.liquid, optionally <type>.<suffix>.json; also robots.txt.liquid
sections/	<name>.liquid, or <name>.json for a section group
blocks/	<name>.liquid; a leading _ hides the block from merchants’ block lists
custom_pages/	lowercase letters, digits and -, ending in .liquid (the name is the URL)
assets/	any of letters, digits, ., - and _; CSS, JS, JSON, SVG, text, Liquid, images, fonts and media
locales/	a language code (ar, en), optionally .default and .schema: en.default.schema.json

Required files

• layout/theme.liquid
• templates/index.json (or templates/index.liquid)
• config/settings_schema.json

Every other template is optional. Without page, blog or article templates, Sooquna draws those pages plainly inside your layout; other missing templates show an error in previews, so add one for each page type your store uses.

theme.json

theme.json

{
  "name": "Sahil",
  "version": "1.1.0",
  "author": "Sooquna",
  "support_url": "https://sooquna.com/docs/themes/sahil",
  "supported_locales": ["en", "ar"],
  "rtl": true
}

Limits

Limit	Value
Files per theme	2,000
Text file size	5 MB
Asset size	20 MB
Sections per template	256
Blocks per section	50 (lower it with max_blocks)
Block nesting	8 levels
Themes per store	20