changedInput schema / properties / blocks / items / anyOf
Previous value: -[
- {
- "additionalProperties": false,
- "properties": {
- "align": {
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- },
- "href": {
- "description": "Where a click on the logo goes, usually the store",
- "maxLength": 2000,
- "pattern": "^https?:\\/\\/\\S+$",
- "type": "string"
- },
- "logo": {
- "description": "The logo set in the workspace's email brand settings, at this size; the store's name when there is none",
- "enum": [
- "none",
- "sm",
- "md",
- "lg"
- ],
- "type": "string"
- },
- "showTo": {
- "additionalProperties": false,
- "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
- "properties": {
- "except": {
- "description": "true: everyone except that segment",
- "type": "boolean"
- },
- "segmentId": {
- "description": "A saved segment's id (readSegments, createSegment)",
- "format": "uuid",
- "type": "string"
- }
- },
- "required": [
- "segmentId"
- ],
- "type": "object"
- },
- "text": {
- "description": "A line beside the logo",
- "maxLength": 200,
- "type": "string"
- },
- "type": {
- "const": "header",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "align": {
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- },
- "background": {
- "description": "Hex: a panel behind it",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "color": {
- "description": "Hex; the brand text colour by default",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "showTo": {
- "additionalProperties": false,
- "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
- "properties": {
- "except": {
- "description": "true: everyone except that segment",
- "type": "boolean"
- },
- "segmentId": {
- "description": "A saved segment's id (readSegments, createSegment)",
- "format": "uuid",
- "type": "string"
- }
- },
- "required": [
- "segmentId"
- ],
- "type": "object"
- },
- "size": {
- "description": "Small, normal or large",
- "enum": [
- "sm",
- "md",
- "lg"
- ],
- "type": "string"
- },
- "text": {
- "description": "Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
- "maxLength": 300,
- "minLength": 1,
- "type": "string"
- },
- "type": {
- "const": "heading",
- "type": "string"
- }
- },
- "required": [
- "type",
- "text"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "align": {
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- },
- "background": {
- "description": "Hex: a panel behind it",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "color": {
- "description": "Hex; the brand text colour by default",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "showTo": {
- "additionalProperties": false,
- "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
- "properties": {
- "except": {
- "description": "true: everyone except that segment",
- "type": "boolean"
- },
- "segmentId": {
- "description": "A saved segment's id (readSegments, createSegment)",
- "format": "uuid",
- "type": "string"
- }
- },
- "required": [
- "segmentId"
- ],
- "type": "object"
- },
- "size": {
- "description": "Small, normal or large",
- "enum": [
- "sm",
- "md",
- "lg"
- ],
- "type": "string"
- },
- "text": {
- "description": "Plain text with **bold**, *italic*, [label](https://...) links and line breaks. Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "type": {
- "const": "text",
- "type": "string"
- }
- },
- "required": [
- "type",
- "text"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "align": {
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- },
- "color": {
- "description": "Hex; the brand colour by default",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "fullWidth": {
- "type": "boolean"
- },
- "label": {
- "maxLength": 120,
- "minLength": 1,
- "type": "string"
- },
- "shape": {
- "enum": [
- "rounded",
- "pill",
- "square"
- ],
- "type": "string"
- },
- "showTo": {
- "additionalProperties": false,
- "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
- "properties": {
- "except": {
- "description": "true: everyone except that segment",
- "type": "boolean"
- },
- "segmentId": {
- "description": "A saved segment's id (readSegments, createSegment)",
- "format": "uuid",
- "type": "string"
- }
- },
- "required": [
- "segmentId"
- ],
- "type": "object"
- },
- "size": {
- "description": "Small, normal or large",
- "enum": [
- "sm",
- "md",
- "lg"
- ],
- "type": "string"
- },
- "textColor": {
- "description": "Hex, for the label on a filled button",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "type": {
- "const": "button",
- "type": "string"
- },
- "url": {
- "maxLength": 2000,
- "pattern": "^https?:\\/\\/\\S+$",
- "type": "string"
- },
- "variant": {
- "description": "primary: filled (the default); link: a text link",
- "enum": [
- "primary",
- "outline",
- "link"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "label",
- "url"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "align": {
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- },
- "alt": {
- "description": "What it shows: read in its place when an inbox blocks images",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- },
- "corners": {
- "enum": [
- "rounded",
- "square"
- ],
- "type": "string"
- },
- "href": {
- "description": "Where a click on it goes",
- "maxLength": 2000,
- "pattern": "^https?:\\/\\/\\S+$",
- "type": "string"
- },
- "showTo": {
- "additionalProperties": false,
- "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
- "properties": {
- "except": {
- "description": "true: everyone except that segment",
- "type": "boolean"
- },
- "segmentId": {
- "description": "A saved segment's id (readSegments, createSegment)",
- "format": "uuid",
- "type": "string"
- }
- },
- "required": [
- "segmentId"
- ],
- "type": "object"
- },
- "type": {
- "const": "image",
- "type": "string"
- },
- "url": {
- "description": "A PNG, JPG or GIF at a public address. Gmail and Outlook show no SVG or WebP",
- "maxLength": 2000,
- "pattern": "^https?:\\/\\/\\S+$",
- "type": "string"
- },
- "width": {
- "enum": [
- "full",
- "half"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "url",
- "alt"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "color": {
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "showTo": {
- "additionalProperties": false,
- "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
- "properties": {
- "except": {
- "description": "true: everyone except that segment",
- "type": "boolean"
- },
- "segmentId": {
- "description": "A saved segment's id (readSegments, createSegment)",
- "format": "uuid",
- "type": "string"
- }
- },
- "required": [
- "segmentId"
- ],
- "type": "object"
- },
- "style": {
- "enum": [
- "solid",
- "dashed",
- "dotted"
- ],
- "type": "string"
- },
- "type": {
- "const": "divider",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "showTo": {
- "additionalProperties": false,
- "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
- "properties": {
- "except": {
- "description": "true: everyone except that segment",
- "type": "boolean"
- },
- "segmentId": {
- "description": "A saved segment's id (readSegments, createSegment)",
- "format": "uuid",
- "type": "string"
- }
- },
- "required": [
- "segmentId"
- ],
- "type": "object"
- },
- "size": {
- "description": "Small, normal or large",
- "enum": [
- "sm",
- "md",
- "lg"
- ],
- "type": "string"
- },
- "type": {
- "const": "spacer",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "count": {
- "description": "For the other sources: how many (4 by default)",
- "maximum": 8,
- "minimum": 1,
- "type": "integer"
- },
- "heading": {
- "maxLength": 120,
- "type": "string"
- },
- "layout": {
- "description": "grid: two to a row (the default); list: one under another",
- "enum": [
- "grid",
- "list"
- ],
- "type": "string"
- },
- "priceLabel": {
- "description": "Over each of those prices: \"Access+ price\"",
- "maxLength": 60,
- "minLength": 1,
- "type": "string"
- },
- "prices": {
- "additionalProperties": {
- "exclusiveMinimum": 0,
- "maximum": 9999999,
- "type": "number"
- },
- "description": "For manual: a price the store does not hold (a member price, a bundle price) by storeId, in the store's currency. Shown in place of the store's price, which is struck through beside it",
- "propertyNames": {
- "pattern": "^[A-Za-z0-9_-]{1,64}$"
- },
- "type": "object"
- },
- "productIds": {
- "description": "For manual: the store's ids (storeId from readProducts)",
- "items": {
- "pattern": "^[A-Za-z0-9_-]{1,64}$",
- "type": "string"
- },
- "maxItems": 8,
- "minItems": 1,
- "type": "array"
- },
- "showTo": {
- "additionalProperties": false,
- "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
- "properties": {
- "except": {
- "description": "true: everyone except that segment",
- "type": "boolean"
- },
- "segmentId": {
- "description": "A saved segment's id (readSegments, createSegment)",
- "format": "uuid",
- "type": "string"
- }
- },
- "required": [
- "segmentId"
- ],
- "type": "object"
- },
- "source": {
- "description": "manual: the products in productIds, all of them, in order. The others are picked for each reader as it is sent",
- "enum": [
- "manual",
- "best_sellers",
- "recently_viewed",
- "cross_sell"
- ],
- "type": "string"
- },
- "type": {
- "const": "products",
- "type": "string"
- }
- },
- "required": [
- "type",
- "source"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "columns": {
- "description": "Two or three side by side, each a few blocks: a card with an image, a line and a link. No products or columns inside",
- "items": {
- "items": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "align": {
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- },
- "background": {
- "description": "Hex: a panel behind it",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "color": {
- "description": "Hex; the brand text colour by default",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "size": {
- "description": "Small, normal or large",
- "enum": [
- "sm",
- "md",
- "lg"
- ],
- "type": "string"
- },
- "text": {
- "description": "Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
- "maxLength": 300,
- "minLength": 1,
- "type": "string"
- },
- "type": {
- "const": "heading",
- "type": "string"
- }
- },
- "required": [
- "type",
- "text"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "align": {
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- },
- "background": {
- "description": "Hex: a panel behind it",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "color": {
- "description": "Hex; the brand text colour by default",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "size": {
- "description": "Small, normal or large",
- "enum": [
- "sm",
- "md",
- "lg"
- ],
- "type": "string"
- },
- "text": {
- "description": "Plain text with **bold**, *italic*, [label](https://...) links and line breaks. Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
- "maxLength": 2000,
- "minLength": 1,
- "type": "string"
- },
- "type": {
- "const": "text",
- "type": "string"
- }
- },
- "required": [
- "type",
- "text"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "align": {
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- },
- "color": {
- "description": "Hex; the brand colour by default",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "fullWidth": {
- "type": "boolean"
- },
- "label": {
- "maxLength": 120,
- "minLength": 1,
- "type": "string"
- },
- "shape": {
- "enum": [
- "rounded",
- "pill",
- "square"
- ],
- "type": "string"
- },
- "size": {
- "description": "Small, normal or large",
- "enum": [
- "sm",
- "md",
- "lg"
- ],
- "type": "string"
- },
- "textColor": {
- "description": "Hex, for the label on a filled button",
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "type": {
- "const": "button",
- "type": "string"
- },
- "url": {
- "maxLength": 2000,
- "pattern": "^https?:\\/\\/\\S+$",
- "type": "string"
- },
- "variant": {
- "description": "primary: filled (the default); link: a text link",
- "enum": [
- "primary",
- "outline",
- "link"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "label",
- "url"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "align": {
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- },
- "alt": {
- "description": "What it shows: read in its place when an inbox blocks images",
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- },
- "corners": {
- "enum": [
- "rounded",
- "square"
- ],
- "type": "string"
- },
- "href": {
- "description": "Where a click on it goes",
- "maxLength": 2000,
- "pattern": "^https?:\\/\\/\\S+$",
- "type": "string"
- },
- "type": {
- "const": "image",
- "type": "string"
- },
- "url": {
- "description": "A PNG, JPG or GIF at a public address. Gmail and Outlook show no SVG or WebP",
- "maxLength": 2000,
- "pattern": "^https?:\\/\\/\\S+$",
- "type": "string"
- },
- "width": {
- "enum": [
- "full",
- "half"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "url",
- "alt"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "color": {
- "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
- "type": "string"
- },
- "style": {
- "enum": [
- "solid",
- "dashed",
- "dotted"
- ],
- "type": "string"
- },
- "type": {
- "const": "divider",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "size": {
- "description": "Small, normal or large",
- "enum": [
- "sm",
- "md",
- "lg"
- ],
- "type": "string"
- },
- "type": {
- "const": "spacer",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- }
- ]
- },
- "maxItems": 6,
- "minItems": 1,
- "type": "array"
- },
- "maxItems": 3,
- "minItems": 2,
- "type": "array"
- },
- "showTo": {
- "additionalProperties": false,
- "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
- "properties": {
- "except": {
- "description": "true: everyone except that segment",
- "type": "boolean"
- },
- "segmentId": {
- "description": "A saved segment's id (readSegments, createSegment)",
- "format": "uuid",
- "type": "string"
- }
- },
- "required": [
- "segmentId"
- ],
- "type": "object"
- },
- "type": {
- "const": "columns",
- "type": "string"
- }
- },
- "required": [
- "type",
- "columns"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "description": "The sender's signature from the brand settings",
- "properties": {
- "showTo": {
- "additionalProperties": false,
- "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
- "properties": {
- "except": {
- "description": "true: everyone except that segment",
- "type": "boolean"
- },
- "segmentId": {
- "description": "A saved segment's id (readSegments, createSegment)",
- "format": "uuid",
- "type": "string"
- }
- },
- "required": [
- "segmentId"
- ],
- "type": "object"
- },
- "type": {
- "const": "signature",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "href": {
+ "description": "Where a click on the logo goes, usually the store",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "logo": {
+ "description": "The logo set in the workspace's email brand settings, at this size; the store's name when there is none",
+ "enum": [
+ "none",
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "text": {
+ "description": "A line beside the logo",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "type": {
+ "const": "header",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex; the brand text colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "text": {
+ "description": "Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 300,
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": {
+ "const": "heading",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "text"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex; the brand text colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "text": {
+ "description": "Plain text with **bold**, *italic*, [label](https://...) links and line breaks. Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": {
+ "const": "text",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "text"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex; the brand colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "fullWidth": {
+ "type": "boolean"
+ },
+ "label": {
+ "maxLength": 120,
+ "minLength": 1,
+ "type": "string"
+ },
+ "shape": {
+ "enum": [
+ "rounded",
+ "pill",
+ "square"
+ ],
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "textColor": {
+ "description": "Hex, for the label on a filled button",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "type": {
+ "const": "button",
+ "type": "string"
+ },
+ "url": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "variant": {
+ "description": "primary: filled (the default); link: a text link",
+ "enum": [
+ "primary",
+ "outline",
+ "link"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "label",
+ "url"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "alt": {
+ "description": "What it shows: read in its place when an inbox blocks images",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "corners": {
+ "enum": [
+ "rounded",
+ "square"
+ ],
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "href": {
+ "description": "Where a click on it goes",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "image",
+ "type": "string"
+ },
+ "url": {
+ "description": "A PNG, JPG or GIF at a public address. Gmail and Outlook show no SVG or WebP",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "width": {
+ "enum": [
+ "full",
+ "half"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url",
+ "alt"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "color": {
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "style": {
+ "enum": [
+ "solid",
+ "dashed",
+ "dotted"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "divider",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "spacer",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "count": {
+ "description": "For the other sources: how many (4 by default)",
+ "maximum": 8,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "heading": {
+ "maxLength": 120,
+ "type": "string"
+ },
+ "headingAlign": {
+ "description": "Where the heading sits; left by default",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "headingColor": {
+ "description": "Hex, for the heading; the brand text colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "headingSize": {
+ "description": "The heading's size: small, normal (the default) or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "layout": {
+ "description": "grid: cards side by side (the default); list: one under another",
+ "enum": [
+ "grid",
+ "list"
+ ],
+ "type": "string"
+ },
+ "perRow": {
+ "description": "In a grid: 2 cards to a row (the default) or 3. A phone stacks them",
+ "enum": [
+ 2,
+ 3
+ ],
+ "type": "number"
+ },
+ "priceLabel": {
+ "description": "Over each of those prices: \"Access+ price\"",
+ "maxLength": 60,
+ "minLength": 1,
+ "type": "string"
+ },
+ "prices": {
+ "additionalProperties": {
+ "exclusiveMinimum": 0,
+ "maximum": 9999999,
+ "type": "number"
+ },
+ "description": "For manual: a price the store does not hold (a member price, a bundle price) by storeId, in the store's currency. Shown in place of the store's price, which is struck through beside it",
+ "propertyNames": {
+ "pattern": "^[A-Za-z0-9_-]{1,64}$"
+ },
+ "type": "object"
+ },
+ "productIds": {
+ "description": "For manual: the store's ids (storeId from readProducts)",
+ "items": {
+ "pattern": "^[A-Za-z0-9_-]{1,64}$",
+ "type": "string"
+ },
+ "maxItems": 8,
+ "minItems": 1,
+ "type": "array"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "source": {
+ "description": "manual: the products in productIds, all of them, in order. The others are picked for each reader as it is sent; cart (the abandoned-cart flow's cart) and order (what a post-purchase email follows) only fill in flow emails, and a campaign leaves them out",
+ "enum": [
+ "manual",
+ "best_sellers",
+ "recently_viewed",
+ "cross_sell",
+ "cart",
+ "order"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "products",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The sender's signature from the brand settings",
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "signature",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "apply": {
+ "description": "true: a button that opens the store with the code already applied. Only a connected Shopify store has the link; on others the code shows without it",
+ "type": "boolean"
+ },
+ "applyLabel": {
+ "description": "The button; \"Apply the discount\" by default",
+ "maxLength": 60,
+ "minLength": 1,
+ "type": "string"
+ },
+ "applyRedirect": {
+ "description": "A page of the store to open after applying it: /collections/sale. The home page by default",
+ "maxLength": 300,
+ "pattern": "^\\/(?!\\/)\\S*$",
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "code": {
+ "description": "The discount code, exactly as the store knows it",
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ },
+ "description": {
+ "description": "Above the code: \"20% off everything\"",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "expiresAt": {
+ "description": "Shown as \"Expires <this>\", as written",
+ "maxLength": 40,
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "coupon",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "code"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A row of social network icons",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "links": {
+ "description": "Left out: the workspace's own social links from its email brand settings (updateEmailBrand), which is usually right",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "kind": {
+ "enum": [
+ "instagram",
+ "facebook",
+ "tiktok",
+ "youtube",
+ "x",
+ "linkedin",
+ "pinterest"
+ ],
+ "type": "string"
+ },
+ "url": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "kind",
+ "url"
+ ],
+ "type": "object"
+ },
+ "maxItems": 8,
+ "minItems": 1,
+ "type": "array"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "style": {
+ "description": "Icons in each network's colour (the default), all dark, or all light for a dark band",
+ "enum": [
+ "color",
+ "dark",
+ "light"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "social",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A video's picture with a play button, linking to it. Email cannot play video",
+ "properties": {
+ "alt": {
+ "description": "Read in place of the picture when images are off",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "thumbnailUrl": {
+ "description": "The picture, a PNG or JPG: needed for a video not on YouTube",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "type": {
+ "const": "video",
+ "type": "string"
+ },
+ "url": {
+ "description": "The video: a YouTube link brings its own picture",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A row of text links, the store's navigation: New, Sale, Collections. Usually under the logo",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex, for the links",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "links": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "label": {
+ "maxLength": 40,
+ "minLength": 1,
+ "type": "string"
+ },
+ "url": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "label",
+ "url"
+ ],
+ "type": "object"
+ },
+ "maxItems": 6,
+ "minItems": 1,
+ "type": "array"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "menu",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "links"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Days, hours, minutes and seconds left, drawn when the email is opened; zeros after the end. The labels under the numbers follow the email language",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex, for the numbers",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "endsAt": {
+ "description": "When it ends, ISO 8601 with its offset: 2026-11-30T23:59:00+02:00",
+ "format": "date-time",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "countdown",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "endsAt"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A customer's review: real words from a real customer, never invented",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "author": {
+ "description": "Who: \"Ioana, Bucharest\"",
+ "maxLength": 80,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "quote": {
+ "description": "A customer's own words, as they wrote them. Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 600,
+ "minLength": 1,
+ "type": "string"
+ },
+ "rating": {
+ "description": "Stars out of five",
+ "maximum": 5,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "review",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "quote"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A picture beside a heading, a line and a button",
+ "properties": {
+ "alt": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "buttonLabel": {
+ "maxLength": 60,
+ "minLength": 1,
+ "type": "string"
+ },
+ "buttonUrl": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "heading": {
+ "description": "Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "href": {
+ "description": "Where a click on the picture goes",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "imageSide": {
+ "description": "The picture on the left (the default) or right of the text; a phone puts it on top",
+ "enum": [
+ "left",
+ "right"
+ ],
+ "type": "string"
+ },
+ "imageUrl": {
+ "description": "A PNG, JPG or GIF at a public address",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "text": {
+ "description": "**bold**, *italic*, [label](https://...) links. Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 1000,
+ "type": "string"
+ },
+ "type": {
+ "const": "feature",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "imageUrl",
+ "alt"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A one-click question: each answer records itself against the reader and shows in the campaign's report",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "highLabel": {
+ "description": "score: the words under 10, \"Very likely\"",
+ "maxLength": 40,
+ "type": "string"
+ },
+ "lowLabel": {
+ "description": "score: the words under 0, \"Not likely\"",
+ "maxLength": 40,
+ "type": "string"
+ },
+ "question": {
+ "description": "What the reader answers: \"How was your order?\". No merge tags: the report counts answers by the question as written",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "scale": {
+ "description": "stars: one to five (the default); score: 0 to 10, as a how-likely-to-recommend question",
+ "enum": [
+ "stars",
+ "score"
+ ],
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "rating",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "question"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Blocks laid out together, framed: one under another or side by side, with a gap, padding, a background or picture, a border and corners. A row of cards is a row container of stack containers",
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "With edgeToEdge: a PNG or JPG covering the band, text on top of it. Outlook on Windows shows the background colour instead, so set one too",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "border": {
+ "description": "Hex: a 1px line around it",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "children": {
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "href": {
+ "description": "Where a click on the logo goes, usually the store",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "logo": {
+ "description": "The logo set in the workspace's email brand settings, at this size; the store's name when there is none",
+ "enum": [
+ "none",
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "text": {
+ "description": "A line beside the logo",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "type": {
+ "const": "header",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex; the brand text colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "text": {
+ "description": "Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 300,
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": {
+ "const": "heading",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "text"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex; the brand text colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "text": {
+ "description": "Plain text with **bold**, *italic*, [label](https://...) links and line breaks. Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": {
+ "const": "text",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "text"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex; the brand colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "fullWidth": {
+ "type": "boolean"
+ },
+ "label": {
+ "maxLength": 120,
+ "minLength": 1,
+ "type": "string"
+ },
+ "shape": {
+ "enum": [
+ "rounded",
+ "pill",
+ "square"
+ ],
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "textColor": {
+ "description": "Hex, for the label on a filled button",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "type": {
+ "const": "button",
+ "type": "string"
+ },
+ "url": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "variant": {
+ "description": "primary: filled (the default); link: a text link",
+ "enum": [
+ "primary",
+ "outline",
+ "link"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "label",
+ "url"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "alt": {
+ "description": "What it shows: read in its place when an inbox blocks images",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "corners": {
+ "enum": [
+ "rounded",
+ "square"
+ ],
+ "type": "string"
+ },
+ "href": {
+ "description": "Where a click on it goes",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "image",
+ "type": "string"
+ },
+ "url": {
+ "description": "A PNG, JPG or GIF at a public address. Gmail and Outlook show no SVG or WebP",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "width": {
+ "enum": [
+ "full",
+ "half"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url",
+ "alt"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "style": {
+ "enum": [
+ "solid",
+ "dashed",
+ "dotted"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "divider",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "spacer",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "count": {
+ "description": "For the other sources: how many (4 by default)",
+ "maximum": 8,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "heading": {
+ "maxLength": 120,
+ "type": "string"
+ },
+ "headingAlign": {
+ "description": "Where the heading sits; left by default",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "headingColor": {
+ "description": "Hex, for the heading; the brand text colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "headingSize": {
+ "description": "The heading's size: small, normal (the default) or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "layout": {
+ "description": "grid: cards side by side (the default); list: one under another",
+ "enum": [
+ "grid",
+ "list"
+ ],
+ "type": "string"
+ },
+ "perRow": {
+ "description": "In a grid: 2 cards to a row (the default) or 3. A phone stacks them",
+ "enum": [
+ 2,
+ 3
+ ],
+ "type": "number"
+ },
+ "priceLabel": {
+ "description": "Over each of those prices: \"Access+ price\"",
+ "maxLength": 60,
+ "minLength": 1,
+ "type": "string"
+ },
+ "prices": {
+ "additionalProperties": {
+ "exclusiveMinimum": 0,
+ "maximum": 9999999,
+ "type": "number"
+ },
+ "description": "For manual: a price the store does not hold (a member price, a bundle price) by storeId, in the store's currency. Shown in place of the store's price, which is struck through beside it",
+ "propertyNames": {
+ "pattern": "^[A-Za-z0-9_-]{1,64}$"
+ },
+ "type": "object"
+ },
+ "productIds": {
+ "description": "For manual: the store's ids (storeId from readProducts)",
+ "items": {
+ "pattern": "^[A-Za-z0-9_-]{1,64}$",
+ "type": "string"
+ },
+ "maxItems": 8,
+ "minItems": 1,
+ "type": "array"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "source": {
+ "description": "manual: the products in productIds, all of them, in order. The others are picked for each reader as it is sent; cart (the abandoned-cart flow's cart) and order (what a post-purchase email follows) only fill in flow emails, and a campaign leaves them out",
+ "enum": [
+ "manual",
+ "best_sellers",
+ "recently_viewed",
+ "cross_sell",
+ "cart",
+ "order"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "products",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The sender's signature from the brand settings",
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "signature",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "apply": {
+ "description": "true: a button that opens the store with the code already applied. Only a connected Shopify store has the link; on others the code shows without it",
+ "type": "boolean"
+ },
+ "applyLabel": {
+ "description": "The button; \"Apply the discount\" by default",
+ "maxLength": 60,
+ "minLength": 1,
+ "type": "string"
+ },
+ "applyRedirect": {
+ "description": "A page of the store to open after applying it: /collections/sale. The home page by default",
+ "maxLength": 300,
+ "pattern": "^\\/(?!\\/)\\S*$",
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "code": {
+ "description": "The discount code, exactly as the store knows it",
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ },
+ "description": {
+ "description": "Above the code: \"20% off everything\"",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "expiresAt": {
+ "description": "Shown as \"Expires <this>\", as written",
+ "maxLength": 40,
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "coupon",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "code"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A row of social network icons",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "links": {
+ "description": "Left out: the workspace's own social links from its email brand settings (updateEmailBrand), which is usually right",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "kind": {
+ "enum": [
+ "instagram",
+ "facebook",
+ "tiktok",
+ "youtube",
+ "x",
+ "linkedin",
+ "pinterest"
+ ],
+ "type": "string"
+ },
+ "url": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "kind",
+ "url"
+ ],
+ "type": "object"
+ },
+ "maxItems": 8,
+ "minItems": 1,
+ "type": "array"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "style": {
+ "description": "Icons in each network's colour (the default), all dark, or all light for a dark band",
+ "enum": [
+ "color",
+ "dark",
+ "light"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "social",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A video's picture with a play button, linking to it. Email cannot play video",
+ "properties": {
+ "alt": {
+ "description": "Read in place of the picture when images are off",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "thumbnailUrl": {
+ "description": "The picture, a PNG or JPG: needed for a video not on YouTube",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "type": {
+ "const": "video",
+ "type": "string"
+ },
+ "url": {
+ "description": "The video: a YouTube link brings its own picture",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A row of text links, the store's navigation: New, Sale, Collections. Usually under the logo",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex, for the links",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "links": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "label": {
+ "maxLength": 40,
+ "minLength": 1,
+ "type": "string"
+ },
+ "url": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "label",
+ "url"
+ ],
+ "type": "object"
+ },
+ "maxItems": 6,
+ "minItems": 1,
+ "type": "array"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "menu",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "links"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Days, hours, minutes and seconds left, drawn when the email is opened; zeros after the end. The labels under the numbers follow the email language",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex, for the numbers",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "endsAt": {
+ "description": "When it ends, ISO 8601 with its offset: 2026-11-30T23:59:00+02:00",
+ "format": "date-time",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "countdown",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "endsAt"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A customer's review: real words from a real customer, never invented",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "author": {
+ "description": "Who: \"Ioana, Bucharest\"",
+ "maxLength": 80,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "quote": {
+ "description": "A customer's own words, as they wrote them. Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 600,
+ "minLength": 1,
+ "type": "string"
+ },
+ "rating": {
+ "description": "Stars out of five",
+ "maximum": 5,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "review",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "quote"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A picture beside a heading, a line and a button",
+ "properties": {
+ "alt": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "buttonLabel": {
+ "maxLength": 60,
+ "minLength": 1,
+ "type": "string"
+ },
+ "buttonUrl": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "heading": {
+ "description": "Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "href": {
+ "description": "Where a click on the picture goes",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "imageSide": {
+ "description": "The picture on the left (the default) or right of the text; a phone puts it on top",
+ "enum": [
+ "left",
+ "right"
+ ],
+ "type": "string"
+ },
+ "imageUrl": {
+ "description": "A PNG, JPG or GIF at a public address",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "text": {
+ "description": "**bold**, *italic*, [label](https://...) links. Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 1000,
+ "type": "string"
+ },
+ "type": {
+ "const": "feature",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "imageUrl",
+ "alt"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A one-click question: each answer records itself against the reader and shows in the campaign's report",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "highLabel": {
+ "description": "score: the words under 10, \"Very likely\"",
+ "maxLength": 40,
+ "type": "string"
+ },
+ "lowLabel": {
+ "description": "score: the words under 0, \"Not likely\"",
+ "maxLength": 40,
+ "type": "string"
+ },
+ "question": {
+ "description": "What the reader answers: \"How was your order?\". No merge tags: the report counts answers by the question as written",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "scale": {
+ "description": "stars: one to five (the default); score: 0 to 10, as a how-likely-to-recommend question",
+ "enum": [
+ "stars",
+ "score"
+ ],
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "rating",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "question"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A box of blocks inside a container: in a row, a card. Holds blocks only, no containers",
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "backgroundImage": {
+ "description": "A PNG or JPG covering the container, its blocks on top. Outlook on Windows shows the background colour instead",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "border": {
+ "description": "Hex: a 1px line around it",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "children": {
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "href": {
+ "description": "Where a click on the logo goes, usually the store",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "logo": {
+ "description": "The logo set in the workspace's email brand settings, at this size; the store's name when there is none",
+ "enum": [
+ "none",
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "text": {
+ "description": "A line beside the logo",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "type": {
+ "const": "header",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex; the brand text colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "text": {
+ "description": "Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 300,
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": {
+ "const": "heading",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "text"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex; the brand text colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "text": {
+ "description": "Plain text with **bold**, *italic*, [label](https://...) links and line breaks. Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 2000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": {
+ "const": "text",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "text"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex; the brand colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "fullWidth": {
+ "type": "boolean"
+ },
+ "label": {
+ "maxLength": 120,
+ "minLength": 1,
+ "type": "string"
+ },
+ "shape": {
+ "enum": [
+ "rounded",
+ "pill",
+ "square"
+ ],
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "textColor": {
+ "description": "Hex, for the label on a filled button",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "type": {
+ "const": "button",
+ "type": "string"
+ },
+ "url": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "variant": {
+ "description": "primary: filled (the default); link: a text link",
+ "enum": [
+ "primary",
+ "outline",
+ "link"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "label",
+ "url"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "alt": {
+ "description": "What it shows: read in its place when an inbox blocks images",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "corners": {
+ "enum": [
+ "rounded",
+ "square"
+ ],
+ "type": "string"
+ },
+ "href": {
+ "description": "Where a click on it goes",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "image",
+ "type": "string"
+ },
+ "url": {
+ "description": "A PNG, JPG or GIF at a public address. Gmail and Outlook show no SVG or WebP",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "width": {
+ "enum": [
+ "full",
+ "half"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url",
+ "alt"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "style": {
+ "enum": [
+ "solid",
+ "dashed",
+ "dotted"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "divider",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "spacer",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "count": {
+ "description": "For the other sources: how many (4 by default)",
+ "maximum": 8,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "heading": {
+ "maxLength": 120,
+ "type": "string"
+ },
+ "headingAlign": {
+ "description": "Where the heading sits; left by default",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "headingColor": {
+ "description": "Hex, for the heading; the brand text colour by default",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "headingSize": {
+ "description": "The heading's size: small, normal (the default) or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "layout": {
+ "description": "grid: cards side by side (the default); list: one under another",
+ "enum": [
+ "grid",
+ "list"
+ ],
+ "type": "string"
+ },
+ "perRow": {
+ "description": "In a grid: 2 cards to a row (the default) or 3. A phone stacks them",
+ "enum": [
+ 2,
+ 3
+ ],
+ "type": "number"
+ },
+ "priceLabel": {
+ "description": "Over each of those prices: \"Access+ price\"",
+ "maxLength": 60,
+ "minLength": 1,
+ "type": "string"
+ },
+ "prices": {
+ "additionalProperties": {
+ "exclusiveMinimum": 0,
+ "maximum": 9999999,
+ "type": "number"
+ },
+ "description": "For manual: a price the store does not hold (a member price, a bundle price) by storeId, in the store's currency. Shown in place of the store's price, which is struck through beside it",
+ "propertyNames": {
+ "pattern": "^[A-Za-z0-9_-]{1,64}$"
+ },
+ "type": "object"
+ },
+ "productIds": {
+ "description": "For manual: the store's ids (storeId from readProducts)",
+ "items": {
+ "pattern": "^[A-Za-z0-9_-]{1,64}$",
+ "type": "string"
+ },
+ "maxItems": 8,
+ "minItems": 1,
+ "type": "array"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "source": {
+ "description": "manual: the products in productIds, all of them, in order. The others are picked for each reader as it is sent; cart (the abandoned-cart flow's cart) and order (what a post-purchase email follows) only fill in flow emails, and a campaign leaves them out",
+ "enum": [
+ "manual",
+ "best_sellers",
+ "recently_viewed",
+ "cross_sell",
+ "cart",
+ "order"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "products",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The sender's signature from the brand settings",
+ "properties": {
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "signature",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "apply": {
+ "description": "true: a button that opens the store with the code already applied. Only a connected Shopify store has the link; on others the code shows without it",
+ "type": "boolean"
+ },
+ "applyLabel": {
+ "description": "The button; \"Apply the discount\" by default",
+ "maxLength": 60,
+ "minLength": 1,
+ "type": "string"
+ },
+ "applyRedirect": {
+ "description": "A page of the store to open after applying it: /collections/sale. The home page by default",
+ "maxLength": 300,
+ "pattern": "^\\/(?!\\/)\\S*$",
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "code": {
+ "description": "The discount code, exactly as the store knows it",
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ },
+ "description": {
+ "description": "Above the code: \"20% off everything\"",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "expiresAt": {
+ "description": "Shown as \"Expires <this>\", as written",
+ "maxLength": 40,
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "coupon",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "code"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A row of social network icons",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "links": {
+ "description": "Left out: the workspace's own social links from its email brand settings (updateEmailBrand), which is usually right",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "kind": {
+ "enum": [
+ "instagram",
+ "facebook",
+ "tiktok",
+ "youtube",
+ "x",
+ "linkedin",
+ "pinterest"
+ ],
+ "type": "string"
+ },
+ "url": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "kind",
+ "url"
+ ],
+ "type": "object"
+ },
+ "maxItems": 8,
+ "minItems": 1,
+ "type": "array"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "style": {
+ "description": "Icons in each network's colour (the default), all dark, or all light for a dark band",
+ "enum": [
+ "color",
+ "dark",
+ "light"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "social",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A video's picture with a play button, linking to it. Email cannot play video",
+ "properties": {
+ "alt": {
+ "description": "Read in place of the picture when images are off",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "thumbnailUrl": {
+ "description": "The picture, a PNG or JPG: needed for a video not on YouTube",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "type": {
+ "const": "video",
+ "type": "string"
+ },
+ "url": {
+ "description": "The video: a YouTube link brings its own picture",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A row of text links, the store's navigation: New, Sale, Collections. Usually under the logo",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex, for the links",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "links": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "label": {
+ "maxLength": 40,
+ "minLength": 1,
+ "type": "string"
+ },
+ "url": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "label",
+ "url"
+ ],
+ "type": "object"
+ },
+ "maxItems": 6,
+ "minItems": 1,
+ "type": "array"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "description": "Small, normal or large",
+ "enum": [
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "menu",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "links"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Days, hours, minutes and seconds left, drawn when the email is opened; zeros after the end. The labels under the numbers follow the email language",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "color": {
+ "description": "Hex, for the numbers",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "endsAt": {
+ "description": "When it ends, ISO 8601 with its offset: 2026-11-30T23:59:00+02:00",
+ "format": "date-time",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "countdown",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "endsAt"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A customer's review: real words from a real customer, never invented",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "author": {
+ "description": "Who: \"Ioana, Bucharest\"",
+ "maxLength": 80,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "quote": {
+ "description": "A customer's own words, as they wrote them. Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 600,
+ "minLength": 1,
+ "type": "string"
+ },
+ "rating": {
+ "description": "Stars out of five",
+ "maximum": 5,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "review",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "quote"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A picture beside a heading, a line and a button",
+ "properties": {
+ "alt": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "buttonLabel": {
+ "maxLength": 60,
+ "minLength": 1,
+ "type": "string"
+ },
+ "buttonUrl": {
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "heading": {
+ "description": "Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 200,
+ "type": "string"
+ },
+ "href": {
+ "description": "Where a click on the picture goes",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "imageSide": {
+ "description": "The picture on the left (the default) or right of the text; a phone puts it on top",
+ "enum": [
+ "left",
+ "right"
+ ],
+ "type": "string"
+ },
+ "imageUrl": {
+ "description": "A PNG, JPG or GIF at a public address",
+ "maxLength": 2000,
+ "pattern": "^https?:\\/\\/\\S+$",
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "text": {
+ "description": "**bold**, *italic*, [label](https://...) links. Merge tags are filled per reader: {{first_name}} or {{first_name|fallback}}, with first_name, last_name, name, city, country",
+ "maxLength": 1000,
+ "type": "string"
+ },
+ "type": {
+ "const": "feature",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "imageUrl",
+ "alt"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "A one-click question: each answer records itself against the reader and shows in the campaign's report",
+ "properties": {
+ "align": {
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "description": "Hex: a colour behind the block. Neighbours with the same colour share it, as one rounded panel",
+ "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+ "type": "string"
+ },
+ "highLabel": {
+ "description": "score: the words under 10, \"Very likely\"",
+ "maxLength": 40,
+ "type": "string"
+ },
+ "lowLabel": {
+ "description": "score: the words under 0, \"Not likely\"",
+ "maxLength": 40,
+ "type": "string"
+ },
+ "question": {
+ "description": "What the reader answers: \"How was your order?\". No merge tags: the report counts answers by the question as written",
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "scale": {
+ "description": "stars: one to five (the default); score: 0 to 10, as a how-likely-to-recommend question",
+ "enum": [
+ "stars",
+ "score"
+ ],
+ "type": "string"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "rating",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "question"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "maxItems": 12,
+ "minItems": 1,
+ "type": "array"
+ },
+ "gap": {
+ "description": "Space between the children; md by default",
+ "enum": [
+ "none",
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "layout": {
+ "description": "stack: one under another (the default); row: side by side, each child a cell (2 to 4), stacked on a phone",
+ "enum": [
+ "stack",
+ "row"
+ ],
+ "type": "string"
+ },
+ "padding": {
+ "description": "Space inside; md by default when it has a background, picture or border",
+ "enum": [
+ "none",
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "radius": {
+ "description": "Rounded corners; md by default when framed",
+ "enum": [
+ "none",
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "rowOnMobile": {
+ "description": "row: true keeps it side by side on a phone, for small things like icons",
+ "type": "boolean"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "container",
+ "type": "string"
+ },
+ "valign": {
+ "description": "row: where cells of different heights sit; top by default",
+ "enum": [
+ "top",
+ "middle",
+ "bottom"
+ ],
+ "type": "string"
+ },
+ "widths": {
+ "description": "row: each child's share of the width in percent, one per child, summing to 100 ([33, 67]); equal when left out",
+ "items": {
+ "maximum": 90,
+ "minimum": 10,
+ "type": "integer"
+ },
+ "maxItems": 4,
+ "minItems": 2,
+ "type": "array"
+ }
+ },
+ "required": [
+ "type",
+ "children"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "maxItems": 12,
+ "minItems": 1,
+ "type": "array"
+ },
+ "edgeToEdge": {
+ "description": "true: the block sits on a band across the whole width of the email, square-cornered, as a banner. Give it a background",
+ "type": "boolean"
+ },
+ "gap": {
+ "description": "Space between the children; md by default",
+ "enum": [
+ "none",
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "layout": {
+ "description": "stack: one under another (the default); row: side by side, each child a cell (2 to 4), stacked on a phone",
+ "enum": [
+ "stack",
+ "row"
+ ],
+ "type": "string"
+ },
+ "padding": {
+ "description": "Space inside; md by default when it has a background, picture or border",
+ "enum": [
+ "none",
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "radius": {
+ "description": "Rounded corners; md by default when framed",
+ "enum": [
+ "none",
+ "sm",
+ "md",
+ "lg"
+ ],
+ "type": "string"
+ },
+ "rowOnMobile": {
+ "description": "row: true keeps it side by side on a phone, for small things like icons",
+ "type": "boolean"
+ },
+ "showOn": {
+ "description": "Show the block on one kind of screen only; left out, on both. Outlook on Windows counts as desktop",
+ "enum": [
+ "desktop",
+ "mobile"
+ ],
+ "type": "string"
+ },
+ "showTo": {
+ "additionalProperties": false,
+ "description": "Who sees the block: only a segment's subscribers, or everyone but them; left out, everyone. Members' prices to members, the way to join to the rest",
+ "properties": {
+ "except": {
+ "description": "true: everyone except that segment",
+ "type": "boolean"
+ },
+ "segmentId": {
+ "description": "A saved segment's id (readSegments, createSegment)",
+ "format": "uuid",
+ "type": "string"
+ }
+ },
+ "required": [
+ "segmentId"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "container",
+ "type": "string"
+ },
+ "valign": {
+ "description": "row: where cells of different heights sit; top by default",
+ "enum": [
+ "top",
+ "middle",
+ "bottom"
+ ],
+ "type": "string"
+ },
+ "widths": {
+ "description": "row: each child's share of the width in percent, one per child, summing to 100 ([33, 67]); equal when left out",
+ "items": {
+ "maximum": 90,
+ "minimum": 10,
+ "type": "integer"
+ },
+ "maxItems": 4,
+ "minItems": 2,
+ "type": "array"
+ }
+ },
+ "required": [
+ "type",
+ "children"
+ ],
+ "type": "object"
+ }
+]