Template Sections
Themes
Template Sections
Manage sections within page templates
GET
Template Sections
Template Sections
Manage sections (modular content blocks) within page templates. All endpoints use the standard response envelope (status, state, message,
data).
Get Template Sections
List all sections in a template with their settings.Request
Path Parameters
The theme ID
Template name (e.g.,
index, product, collection, page, cart)Response
data.sections is an array of section objects, in render order. Each object
includes the section’s settings, blocks and block order, plus its location
(header, template, or footer).
Array of section objects
Update Section Settings
Update settings for a specific section.Request
Body Parameters
Path of the template/file containing the section (e.g.,
templates/index.json)Section settings to save
Response
The saved settings are returned underdata.settings.
Add Section
Add a new section to a template. The new section is appended to the end of the template’s section order.Request
Body Parameters
Section type to add (must exist in the theme’s sections folder)
Response
Returns201 with the generated section ID under data.sectionId.
Delete Section
Remove a section from a template.Request
Query Parameters
Template containing the section
Response
Delete returns a message envelope (nodata payload).
Common Section Types
| Section Type | Description |
|---|---|
image-banner | Hero banner with image and text |
featured-collection | Product grid from collection |
rich-text | Text content block |
image-with-text | Side-by-side image and text |
slideshow | Image carousel |
video | Embedded video |
newsletter | Email signup form |
contact-form | Contact form |
multicolumn | Multiple columns of content |
collage | Image collage layout |
collection-list | Grid of collection cards |
Error Response
Errors return the envelope withstate: "error", a numeric HTTP status, and a
message.
| Status | Description |
|---|---|
401 | Invalid or missing access token |
403 | App doesn’t have the required read_themes / write_themes scope |
404 | Theme, template, or section not found |
400 | Missing or invalid parameters |