---
title: "Sherpo merchant API"
description: "Rich text fields take HTML in a closed format; anything else is refused as invalid, naming the field's path and the reason, so fix it and retry. Allowed: p, h1 (Title), h2 (Heading), h3 (Subheading), br; marks strong, em, u, s, sup, sub, code (b as strong, i as em, del as s, strike as s); a with href (http, https, mailto, tel, ftp, ftps, callto, sms, cid, xmpp, irc, ircs or a relative path), target=\"_blank\"; span with style color or background-color (#rgb or #rrggbb); style text-align (left, center, right, justify) on p and h1 to h3; ul; ol (start); li (data-checked=\"true\" or \"false\" for a task list); table, thead, tbody, tr, th, td (colspan, rowspan); pre with one code (class=\"language-<id>\", the id one of bash, c, cpp, csharp, css, go, xml, java, javascript, json, kotlin, markdown, php, python, ruby, rust, sql, swift, typescript, yaml); blockquote; hr; details (open) with its summary first; figure with at most one figcaption, first or last; a link's rel (noopener, noreferrer, nofollow) is read and never stored. Images, videos, audio, slideshows, formulas, diagrams, downloads and other blocks are <block type=\"…\" props=\"{…JSON…}\"></block> elements (no raw img or video); which types a field takes is in its description. getBodySchema answers each block's props, their values and which are required, for every kind of body; a block with an unknown type, an unknown prop or a value outside its set is refused, naming the block and what the prop takes. Refused: any other tag, attribute or style (div, section, img, iframe, script, comments…), a link or a block inside a link, a figure inside a figure. At most 1 MiB of UTF-8 (and each field's own limit), markup nested at most 32 deep, tables covering at most 10000 cells in all (each its rows times its widest row, spans counted). Reads return the stored canonical form, wrapped in <rich-text version=\"1\">; send it back as it is to keep a text. To write Markdown instead, set text_format to \"markdown\": each text, up to 64 KiB, is converted into the format, raw HTML in it kept, a $$ fence or a paragraph that is one $$ … $$ line a formula block (a fence nothing closes stays text), and a mermaid fence a diagram block (one of a type the store's page doesn't draw, or that the diagram rules refuse, stays code; one that still can't be drawn, or past 10 new diagrams in a save, is refused), and validated the same way; a Markdown image is refused, since an image is a block. Example: <h1>Welcome</h1><p style=\"text-align: center\">Start with <strong>the intro</strong>, then <a href=\"https://example.com/notes\" target=\"_blank\">read the notes</a>.</p><ul><li data-checked=\"true\"><p>Watch the intro</p></li><li data-checked=\"false\"><p>Take the <span style=\"color: #047857\">quiz</span></p></li></ul><details><summary>Why it works</summary><p>Short lessons stick.</p></details> The guide: https://api.sherpo.io/merchant/docs/text."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.sherpo.io/llms.txt
> Use this file to discover all available pages before exploring further.

Rich text fields take HTML in a closed format; anything else is refused as invalid, naming the field's path and the reason, so fix it and retry. Allowed: p, h1 (Title), h2 (Heading), h3 (Subheading), br; marks strong, em, u, s, sup, sub, code (b as strong, i as em, del as s, strike as s); a with href (http, https, mailto, tel, ftp, ftps, callto, sms, cid, xmpp, irc, ircs or a relative path), target="_blank"; span with style color or background-color (#rgb or #rrggbb); style text-align (left, center, right, justify) on p and h1 to h3; ul; ol (start); li (data-checked="true" or "false" for a task list); table, thead, tbody, tr, th, td (colspan, rowspan); pre with one code (class="language-<id>", the id one of bash, c, cpp, csharp, css, go, xml, java, javascript, json, kotlin, markdown, php, python, ruby, rust, sql, swift, typescript, yaml); blockquote; hr; details (open) with its summary first; figure with at most one figcaption, first or last; a link's rel (noopener, noreferrer, nofollow) is read and never stored. Images, videos, audio, slideshows, formulas, diagrams, downloads and other blocks are <block type="…" props="{…JSON…}"></block> elements (no raw img or video); which types a field takes is in its description. getBodySchema answers each block's props, their values and which are required, for every kind of body; a block with an unknown type, an unknown prop or a value outside its set is refused, naming the block and what the prop takes. Refused: any other tag, attribute or style (div, section, img, iframe, script, comments…), a link or a block inside a link, a figure inside a figure. At most 1 MiB of UTF-8 (and each field's own limit), markup nested at most 32 deep, tables covering at most 10000 cells in all (each its rows times its widest row, spans counted). Reads return the stored canonical form, wrapped in <rich-text version="1">; send it back as it is to keep a text. To write Markdown instead, set text_format to "markdown": each text, up to 64 KiB, is converted into the format, raw HTML in it kept, a $$ fence or a paragraph that is one $$ … $$ line a formula block (a fence nothing closes stays text), and a mermaid fence a diagram block (one of a type the store's page doesn't draw, or that the diagram rules refuse, stays code; one that still can't be drawn, or past 10 new diagrams in a save, is refused), and validated the same way; a Markdown image is refused, since an image is a block. Example: <h1>Welcome</h1><p style="text-align: center">Start with <strong>the intro</strong>, then <a href="https://example.com/notes" target="_blank">read the notes</a>.</p><ul><li data-checked="true"><p>Watch the intro</p></li><li data-checked="false"><p>Take the <span style="color: #047857">quiz</span></p></li></ul><details><summary>Why it works</summary><p>Short lessons stick.</p></details> The guide: https://api.sherpo.io/merchant/docs/text.

Version: 1

## Servers

- `https://api.sherpo.io/merchant`

## Sections

- [store](/merchant-api/reference/tags/store/)
- [product](/merchant-api/reference/tags/product/)
- [price](/merchant-api/reference/tags/price/)
- [entry](/merchant-api/reference/tags/entry/)
- [custompage](/merchant-api/reference/tags/custompage/)
- [file](/merchant-api/reference/tags/file/)
- [transaction](/merchant-api/reference/tags/transaction/)
- [customer](/merchant-api/reference/tags/customer/)
- [subscription](/merchant-api/reference/tags/subscription/)
- [affiliate](/merchant-api/reference/tags/affiliate/)
- [discount](/merchant-api/reference/tags/discount/)
- [review](/merchant-api/reference/tags/review/)
- [quiz](/merchant-api/reference/tags/quiz/)
- [certificate](/merchant-api/reference/tags/certificate/)
- [attendee](/merchant-api/reference/tags/attendee/)
- [site](/merchant-api/reference/tags/site/)
- [organization](/merchant-api/reference/tags/organization/)
- [integration](/merchant-api/reference/tags/integration/)
- [automation](/merchant-api/reference/tags/automation/)
- [portfolio](/merchant-api/reference/tags/portfolio/)


Source: https://docs.sherpo.io/merchant-api/reference/index.md
