Insert a new section.
Show fields
Show fields
ID
Insert immediately after this section id. Column children are not valid anchors. Omit after, before, and parent to insert last but above the footer.
ID
Insert immediately before this section id. Column children are not valid anchors.
Insert a button section.
Show fields
Show fields
String
Fixed URL.
String
Button label.
Int
Corner radius in pixels.
String
Fill color.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Label font size in pixels.
Boolean
Stretch the button to the content width.
Horizontal alignment.
How the destination is resolved.
Padding inside the button.
String
CamelCase Url field on this template’s
trigger. Used when linkType is DYNAMIC_VARIABLE.String
Section background color.
Padding around the section.
String
Border color.
Int
Border width in pixels.
String
Label color.
Insert a Chrome dinosaur section.
Show fields
Show fields
String
Section background color.
Padding around the section.
Insert a column layout. Pass
columns for the complete child list, or omit it for empty slots (columnCount, default 2).Show fields
Show fields
Int
Number of columns (2–6). Derived from columns.length when columns is set; if both are set they must match. Without columns, changing this pads or trims empty trailing slots.
Complete child list, length 2–6. Null items are empty slots. Replaces every child; new ids are minted from the payloads.
Int
Gap between columns in pixels.
String
Section background color.
Padding around the section.
Boolean
Stack columns on small screens.
Vertical alignment of column children.
Insert a discount section.
Show fields
Show fields
String
Background color behind the discount text.
ID
DiscountCode id or legacyId from discountCodes.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Font size in pixels.
Font weight.
Horizontal alignment.
String
Section background color.
Padding around the section.
String
Text color.
Insert a footer section.
Show fields
Show fields
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Font size in pixels.
Horizontal alignment.
Named horizontal padding.
Inner padding.
String
Section background color.
Padding around the section.
String
Footer text color.
Boolean
When true, render the address stored on this template. When false, use the team default address.
Named vertical padding.
Insert a header section.
Show fields
Show fields
String
Alt text.
String
Clickthrough URL.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written. Applies only when headerType is TEXT.
Int
Font size in pixels.
Image, logo, or text.
Int
Image height in pixels.
String
HTTPS URL of the header image or logo. To use a file, upload it with
uploadMarketingImage (channel EMAIL) and pass the returned URL.Horizontal layout.
Int
Logo height in pixels.
String
Section background color.
Padding around the section.
String
Header text.
String
Text color.
Insert an HTML section.
Show fields
Show fields
String
Raw HTML markup.
String
Section background color.
Padding around the section.
Insert an image section.
Show fields
Show fields
String
Alt text.
String
Caption text.
How the clickthrough is resolved.
String
CamelCase Url field on this template’s
trigger. Used when clickthroughLinkType is DYNAMIC_VARIABLE.String
Clickthrough URL.
Named horizontal padding.
String
HTTPS URL of the image. To use a file, upload it with
uploadMarketingImage (channel EMAIL) and pass the returned URL.Padding around the image.
String
Section background color.
Padding around the section.
Boolean
Show the caption.
Named vertical padding.
Int
Deprecated. Do not send. Column children are a complete
columns list; parent without this field still appends to an interactive-review success section.Insert a line section.
Show fields
Show fields
String
Line color.
Named horizontal padding.
Padding around the line.
String
Section background color.
Padding around the section.
Named vertical padding.
Insert a menu section.
Show fields
Show fields
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Font size in pixels.
Horizontal alignment.
Int
Space between items in pixels.
String
Color of menu links.
Menu links. Replaces the full list when set.
String
Section background color.
Padding around the section.
Boolean
Stack items on small screens.
String
Text color.
Boolean
Use
itemSpacing.ID
An interactive-review id. Appends the inserted block to that review’s success section. Cannot combine with after or before. Column children are not filled this way; pass
columns on the column payload.Insert a products section. The trigger must provide Cart Context. Not a column child. recommendedProductFilterId is a product filter id, or 00000000feedb10cfeedb10c when this trigger already carries products.
Show fields
Show fields
Checkout button.
Int
How many products sit in a row when layout is columns. 1 to 4.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Card alignment when the layout is columns.
Float
Width divided by height. Omit to keep the stored value.
Int
Image corner radius in pixels.
How the image fills its box.
Image size when the layout is rows.
Rows or columns.
Button on each product.
Products used when productSelectionType is MANUAL.
Int
How many dynamic products to show. 1 to 10.
Dynamic recommendations or a hand-picked list.
Which of this account’s stores the products come from.
ID
Saved product filter id, or 00000000feedb10cfeedb10c for products this trigger already carries. Omit to leave it unchanged.
String
Cart Context key. Defaults to cartContext.
String
Section background color.
Padding around the section.
Boolean
Show the per-product button.
Boolean
Show the checkout button.
Boolean
Show product images.
Boolean
Show prices.
Boolean
Show quantity.
Boolean
Show product titles.
Boolean
Stack columns on a narrow screen.
String
Text color.
Int
Title font size in pixels.
Insert a QR code section.
Show fields
Show fields
How the destination is resolved.
String
CamelCase QR context field. Used when linkType is DYNAMIC_VARIABLE.
String
Section background color.
Padding around the section.
String
Fixed URL.
Insert a scratch-to-reveal section.
Show fields
Show fields
Int
Corner radius in pixels.
ID
DiscountCode id or legacyId from discountCodes.
String
Copy shown before scratching.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Font size in pixels.
Font weight.
Horizontal alignment.
Padding inside the scratch-off area.
String
Color of the scratch-off overlay.
Size of the scratch cursor.
String
Color behind the hidden discount.
String
Section background color.
Padding around the section.
String
Text color.
Insert a shoppable products section. The trigger must provide Cart Context. Not a column child. productFilterId is a product filter id.
Show fields
Show fields
Int
Card corner radius in pixels.
Checkout button.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Card alignment.
Float
Width divided by height.
How the image fills its box.
Products used when productSelectionType is MANUAL.
Int
How many dynamic products to show. 1 to 10.
Button on each product.
ID
Saved product filter id. Omit to leave it unchanged.
Dynamic recommendations or a hand-picked list.
Which of this account’s stores the products come from.
String
Cart Context key. Defaults to cartContext.
String
Section background color.
Padding around the section.
Which parts of each card are visible.
Card size.
String
Text color.
Insert a socials section.
Show fields
Show fields
Horizontal alignment.
Icon color treatment.
Int
Padding around each icon in pixels.
String
Section background color.
Padding around the section.
Social icons and URLs. Replaces the full list when set.
Boolean
Use brand-kit socials.
Insert a spacer section.
Show fields
Show fields
Int
Height in pixels.
String
Section background color.
Padding around the section.
Insert a subscription add-to-order section.
Show fields
Show fields
String
Section background color.
Padding around the section.
Insert a skip-or-delay section.
Show fields
Show fields
Charge-date display.
Replaces the delay-option list.
Confirmation copy after a delay.
Body font.
Landing-page copy and button.
String
Section background color.
Padding around the section.
Skip option.
Confirmation copy after a skip.
String
Text color.
Insert a subscription swap-product section.
Show fields
Show fields
String
Section background color.
Padding around the section.
Insert a table section.
Show fields
Show fields
String
Table border color.
Table border style.
Int
Table border width in pixels.
Padding inside body cells.
Vertical alignment of cell content.
Complete column list. Replaces every column.
One cell per column. Replaces the dynamic row template.
String
Header row background color.
Boolean
Bold header text.
Int
Header font size in pixels.
Boolean
Italic header text.
Padding inside header cells.
Boolean
Strikethrough header text.
String
Header cell text color.
Boolean
Underlined header text.
Horizontal alignment of the table.
Int
Cap on dynamic rows. Null shows all.
How columns stack on small screens.
Static grid vs event-driven rows.
String
Event path for dynamic rows.
String
Section background color.
Padding around the section.
Boolean
Show column header labels.
Complete static grid. Replaces every row.
Insert a text section.
Show fields
Show fields
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Font size in pixels.
String
Link color.
String
Section background color.
Padding around the section.
String
Body HTML/text.
String
Text color.
Insert an order-summary section. The trigger must provide a Trackable Summary. Not a column child.
Show fields
Show fields
String
Compare-at price label.
Gift-receipt button.
[String!]
Item labels as they appear on the order. Not variable-catalog keys.
String
Font family.
Letter case for section headers.
Float
Line-item image aspect ratio.
Int
Line-item image corner radius in pixels.
How the line-item image fills its box.
Line-item image size.
String
Items header.
String
Order-details header.
String
Other-items header.
Boolean
Label the cost summary as payment delayed.
String
Savings label.
String
CamelCase Trackable Summary field. Must be an
orderSummary context object for this trigger. Insert defaults to orderSummary.String
Section background color.
Padding around the section.
Boolean
Show the compare-at price.
Boolean
Show the cost summary.
Boolean
Show the gift-receipt button.
Boolean
Show custom field labels on each item.
Boolean
Show the customer.
Boolean
Show line-item images.
Boolean
Show order number and date.
Boolean
Show payment information.
Boolean
Show the price.
Boolean
Show the quantity.
Boolean
Show the savings summary.
Boolean
Show titles.
Boolean
Limit line items to Try First items.
Boolean
Show the variant.
Boolean
Show metafields on each item.
String
Subtotal label.
String
Body text color.
[String!]
Shopify metafield name or namespace.key. Not variable-catalog keys.
Insert a tracking-info section. The trigger must provide a Tracker. Not a column child.
Show fields
Show fields
String
Tracking button background.
Int
Tracking button corner radius in pixels.
Padding inside the tracking button.
String
Tracking button label.
String
Tracking button text color.
Boolean
Whether the tracking button is shown.
String
Font family.
Boolean
Hide the estimated delivery date.
String
CamelCase Tracker field. Must be a
tracker context object for this trigger. Insert defaults to tracker.String
Section background color.
Padding around the section.
String
Status timeline outline color.
String
Status timeline fill color.
String
Body text color.
Remove a section.
Show fields
Show fields
ID!
required
The section’s id (
blockId).Patch an existing section.
Show fields
Show fields
Patch a button section.
Show fields
Show fields
String
Fixed URL.
String
Button label.
Int
Corner radius in pixels.
String
Fill color.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Label font size in pixels.
Boolean
Stretch the button to the content width.
Horizontal alignment.
How the destination is resolved.
Padding inside the button.
String
CamelCase Url field on this template’s
trigger. Used when linkType is DYNAMIC_VARIABLE.String
Section background color.
Padding around the section.
String
Border color.
Int
Border width in pixels.
String
Label color.
Patch a Chrome dinosaur section.
Show fields
Show fields
String
Section background color.
Padding around the section.
Patch column layout, or replace children with a complete
columns list. Decreasing columnCount without columns is rejected if trailing slots still have sections.Show fields
Show fields
Int
Number of columns (2–6). Derived from columns.length when columns is set; if both are set they must match. Without columns, changing this pads or trims empty trailing slots.
Complete child list, length 2–6. Null items are empty slots. Replaces every child; new ids are minted from the payloads.
Int
Gap between columns in pixels.
String
Section background color.
Padding around the section.
Boolean
Stack columns on small screens.
Vertical alignment of column children.
Patch a discount section.
Show fields
Show fields
String
Background color behind the discount text.
ID
DiscountCode id or legacyId from discountCodes.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Font size in pixels.
Font weight.
Horizontal alignment.
String
Section background color.
Padding around the section.
String
Text color.
Patch a footer section.
Show fields
Show fields
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Font size in pixels.
Horizontal alignment.
Named horizontal padding.
Inner padding.
String
Section background color.
Padding around the section.
String
Footer text color.
Boolean
When true, render the address stored on this template. When false, use the team default address.
Named vertical padding.
Patch a header section.
Show fields
Show fields
String
Alt text.
String
Clickthrough URL.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written. Applies only when headerType is TEXT.
Int
Font size in pixels.
Image, logo, or text.
Int
Image height in pixels.
String
HTTPS URL of the header image or logo. To use a file, upload it with
uploadMarketingImage (channel EMAIL) and pass the returned URL.Horizontal layout.
Int
Logo height in pixels.
String
Section background color.
Padding around the section.
String
Header text.
String
Text color.
Patch an HTML section.
Show fields
Show fields
String
Raw HTML markup.
String
Section background color.
Padding around the section.
ID!
required
The section’s id (
blockId).Patch an image section.
Show fields
Show fields
String
Alt text.
String
Caption text.
How the clickthrough is resolved.
String
CamelCase Url field on this template’s
trigger. Used when clickthroughLinkType is DYNAMIC_VARIABLE.String
Clickthrough URL.
Named horizontal padding.
String
HTTPS URL of the image. To use a file, upload it with
uploadMarketingImage (channel EMAIL) and pass the returned URL.Padding around the image.
String
Section background color.
Padding around the section.
Boolean
Show the caption.
Named vertical padding.
Patch a line section.
Show fields
Show fields
String
Line color.
Named horizontal padding.
Padding around the line.
String
Section background color.
Padding around the section.
Named vertical padding.
Patch a menu section.
Show fields
Show fields
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Font size in pixels.
Horizontal alignment.
Int
Space between items in pixels.
String
Color of menu links.
Menu links. Replaces the full list when set.
String
Section background color.
Padding around the section.
Boolean
Stack items on small screens.
String
Text color.
Boolean
Use
itemSpacing.Patch a products section.
Show fields
Show fields
Checkout button.
Int
How many products sit in a row when layout is columns. 1 to 4.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Card alignment when the layout is columns.
Float
Width divided by height. Omit to keep the stored value.
Int
Image corner radius in pixels.
How the image fills its box.
Image size when the layout is rows.
Rows or columns.
Button on each product.
Products used when productSelectionType is MANUAL.
Int
How many dynamic products to show. 1 to 10.
Dynamic recommendations or a hand-picked list.
Which of this account’s stores the products come from.
ID
Saved product filter id, or 00000000feedb10cfeedb10c for products this trigger already carries. Omit to leave it unchanged.
String
Cart Context key. Defaults to cartContext.
String
Section background color.
Padding around the section.
Boolean
Show the per-product button.
Boolean
Show the checkout button.
Boolean
Show product images.
Boolean
Show prices.
Boolean
Show quantity.
Boolean
Show product titles.
Boolean
Stack columns on a narrow screen.
String
Text color.
Int
Title font size in pixels.
Patch a QR code section.
Show fields
Show fields
How the destination is resolved.
String
CamelCase QR context field. Used when linkType is DYNAMIC_VARIABLE.
String
Section background color.
Padding around the section.
String
Fixed URL.
Patch a scratch-to-reveal section.
Show fields
Show fields
Int
Corner radius in pixels.
ID
DiscountCode id or legacyId from discountCodes.
String
Copy shown before scratching.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Font size in pixels.
Font weight.
Horizontal alignment.
Padding inside the scratch-off area.
String
Color of the scratch-off overlay.
Size of the scratch cursor.
String
Color behind the hidden discount.
String
Section background color.
Padding around the section.
String
Text color.
Patch a shoppable products section.
Show fields
Show fields
Int
Card corner radius in pixels.
Checkout button.
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Card alignment.
Float
Width divided by height.
How the image fills its box.
Products used when productSelectionType is MANUAL.
Int
How many dynamic products to show. 1 to 10.
Button on each product.
ID
Saved product filter id. Omit to leave it unchanged.
Dynamic recommendations or a hand-picked list.
Which of this account’s stores the products come from.
String
Cart Context key. Defaults to cartContext.
String
Section background color.
Padding around the section.
Which parts of each card are visible.
Card size.
String
Text color.
Patch a socials section.
Show fields
Show fields
Horizontal alignment.
Icon color treatment.
Int
Padding around each icon in pixels.
String
Section background color.
Padding around the section.
Social icons and URLs. Replaces the full list when set.
Boolean
Use brand-kit socials.
Patch a spacer section.
Show fields
Show fields
Int
Height in pixels.
String
Section background color.
Padding around the section.
Patch a subscription add-to-order section.
Show fields
Show fields
String
Section background color.
Padding around the section.
Patch a skip-or-delay section.
Show fields
Show fields
Charge-date display.
Replaces the delay-option list.
Confirmation copy after a delay.
Body font.
Landing-page copy and button.
String
Section background color.
Padding around the section.
Skip option.
Confirmation copy after a skip.
String
Text color.
Patch a subscription swap-product section.
Show fields
Show fields
String
Section background color.
Padding around the section.
Patch a table section.
Show fields
Show fields
String
Table border color.
Table border style.
Int
Table border width in pixels.
Padding inside body cells.
Vertical alignment of cell content.
Complete column list. Replaces every column.
One cell per column. Replaces the dynamic row template.
String
Header row background color.
Boolean
Bold header text.
Int
Header font size in pixels.
Boolean
Italic header text.
Padding inside header cells.
Boolean
Strikethrough header text.
String
Header cell text color.
Boolean
Underlined header text.
Horizontal alignment of the table.
Int
Cap on dynamic rows. Null shows all.
How columns stack on small screens.
Static grid vs event-driven rows.
String
Event path for dynamic rows.
String
Section background color.
Padding around the section.
Boolean
Show column header labels.
Complete static grid. Replaces every row.
Patch a text section.
Show fields
Show fields
String
One of the email builder’s fonts (Arial, Courier New, Georgia, Lucida Sans Unicode, Tahoma, Times New Roman, Trebuchet MS, Verdana, Nunito, Poppins, Raleway, Inter, Pacifico) or a font from the store’s brand kit. A single name gets a fallback of the same kind; a comma-separated list is used as written.
Int
Font size in pixels.
String
Link color.
String
Section background color.
Padding around the section.
String
Body HTML/text.
String
Text color.
Patch an order-summary section.
Show fields
Show fields
String
Compare-at price label.
Gift-receipt button.
[String!]
Item labels as they appear on the order. Not variable-catalog keys.
String
Font family.
Letter case for section headers.
Float
Line-item image aspect ratio.
Int
Line-item image corner radius in pixels.
How the line-item image fills its box.
Line-item image size.
String
Items header.
String
Order-details header.
String
Other-items header.
Boolean
Label the cost summary as payment delayed.
String
Savings label.
String
CamelCase Trackable Summary field. Must be an
orderSummary context object for this trigger. Insert defaults to orderSummary.String
Section background color.
Padding around the section.
Boolean
Show the compare-at price.
Boolean
Show the cost summary.
Boolean
Show the gift-receipt button.
Boolean
Show custom field labels on each item.
Boolean
Show the customer.
Boolean
Show line-item images.
Boolean
Show order number and date.
Boolean
Show payment information.
Boolean
Show the price.
Boolean
Show the quantity.
Boolean
Show the savings summary.
Boolean
Show titles.
Boolean
Limit line items to Try First items.
Boolean
Show the variant.
Boolean
Show metafields on each item.
String
Subtotal label.
String
Body text color.
[String!]
Shopify metafield name or namespace.key. Not variable-catalog keys.
Patch a tracking-info section.
Show fields
Show fields
String
Tracking button background.
Int
Tracking button corner radius in pixels.
Padding inside the tracking button.
String
Tracking button label.
String
Tracking button text color.
Boolean
Whether the tracking button is shown.
String
Font family.
Boolean
Hide the estimated delivery date.
String
CamelCase Tracker field. Must be a
tracker context object for this trigger. Insert defaults to tracker.String
Section background color.
Padding around the section.
String
Status timeline outline color.
String
Status timeline fill color.
String
Body text color.