Skip to main content
Use the blogpost editor to publish announcements, updates, and campaigns for your trading platform. Write the article in Content using Markdown: plain text with simple symbols for headings, emphasis, lists, links, and media.
The blogpost editor is available only in Orderly One and only to graduated builders. Complete Builder Onboarding before creating and publishing posts.

​
Start here

  1. Create a blogpost and choose Announcement, Update, or Campaign.
  2. Enter Title and Summary in their own fields.
  3. Write the article in Content, starting with an introduction or a ## heading.
  4. Use Upload image and Embed video to add media.
  5. Check Live preview and save your draft before publishing.
The preview is illustrative. Your trading platform may display the content with different styling or positioning.
Copy the text inside the example boxes into Content. Do not copy the surrounding triple-backtick markers: code blocks are not supported in blogposts.

​
Formatting cheat sheet

​
Paragraphs and line breaks

Separate paragraphs with a blank line:
Pressing Enter once usually keeps text in the same paragraph. For a deliberate line break within a paragraph, add a backslash at the end of the first line:

​
Headings

Use ##, ###, and ####, with a space after the hash symbols:
The editor has a separate Title field, so do not use # headings in Content. Five- and six-level headings are also unsupported. Use ## for main sections and ### for their subsections.

​
Bold and italic

Use bold for short points that need emphasis rather than entire paragraphs.

​
Lists

Use bullets for requirements and numbered lists for steps:
Indent nested bullets beneath their parent:
Checkbox/task-list syntax such as - [ ] Register is not supported. Put the label in square brackets and the destination in parentheses:
Use complete HTTPS addresses. HTTP, email (mailto:), JavaScript, and relative links such as /campaign are unsupported. Link labels do not need an @ prefix. Plain HTTPS URLs are accepted, but descriptive labels are easier to read.

​
Quotes and dividers

Start a quotation or callout with >:
Custom colored alert boxes are not supported. To insert a divider, put --- on its own line, with blank lines before and after:

​
Tables

Use pipes between columns and a row of dashes below the header:
Alignment markers are supported:
Keep tables narrow enough for mobile. Use subsections or bullets for lengthy requirements. Write a literal pipe inside a cell as \|.

​
Add images

  1. Click Upload image above Content and choose your file.
  2. Find it in Uploaded images below Content.
  3. Place the text cursor where the image should appear.
  4. Click Insert image at cursor, or use Copy image Markdown and paste it.
  5. Check Live preview and save your draft.
Uploading and inserting are separate steps. An uploaded image appears in the article body only after its Markdown reference is inserted.

​
Image Markdown

The editor generates a reference like this:
Use the reference generated for an image uploaded to the current post. The ID above is illustrative; invented IDs and references from other posts will not work.
  • The leading ! makes an image rather than a text link.
  • Edit the text inside [...] to describe the image for accessibility.
  • Keep the asset://... reference unchanged.
  • Put the image on its own line, with blank lines around it.
  • For a visible caption, add a paragraph below the image. The accessibility description is not a visible caption.
External image Markdown such as ![Chart](https://example.com/chart.png) is unsupported. If you have permission to use the image, download and upload it through the editor. HTML image tags and base64/data-URI images are also unsupported in Content. Selecting a banner or logo does not insert it into Content. Insert the reference separately if it should also appear in the body. Banner and logo must use different uploaded assets when both are selected. Images display responsively. Custom width, height, alignment, and CSS cannot be specified in image Markdown. Before deleting an image, remove body references and clear any banner/logo selection using it. Images used by published versions may still be in use.

​
Image limits

Repeated references to the same image count toward the 10-occurrence limit. GIF and SVG uploads are unsupported.

​
Embed videos

  1. Place the cursor where the video should appear.
  2. Click Embed video above Content.
  3. Enter a descriptive Video title.
  4. Paste a supported HTTPS YouTube or Vimeo URL.
  5. Click Insert video and check Live preview.
The dialog inserts Markdown and converts supported share/watch URLs into embed URLs.

​
Video Markdown

Use a link with the exact marker "embed-video":
Replace these example URLs and titles with your own. Put each embed in its own paragraph, with blank lines before and after:
Without "embed-video", the URL is an ordinary clickable link:

​
Supported URLs and limits

  • Up to 5 embedded videos per post.
  • Titles must contain 1-120 characters.
  • URLs must be HTTPS and no longer than 2,048 characters.
  • Use individual videos, not channels or playlists.
  • Sharing/tracking parameters are removed during URL conversion. Do not rely on timestamp parameters to set the player’s start position.
  • Videos must permit embedding for your audience. Private, removed, region-restricted, or embedding-disabled videos may not play.
  • Direct video uploads, MP4 links as players, other providers, and pasted HTML iframe code are unsupported. Use an ordinary HTTPS link for other providers.

​
Unsupported formatting

Avoid four-space-indented ordinary paragraphs: Markdown interprets them as code blocks. Emojis and ordinary Unicode text are supported, but invisible control or direction-changing characters may be rejected.

​
Ready-to-edit template

Set Title and Summary separately. Copy the following into Content, replace the sample details, and insert your own images with the editor:

​
Before publishing

  • Title: required, up to 120 characters. Summary: required for publication, up to 80 characters.
  • Content: required for publication, up to 100 KiB (102,400 UTF-8 bytes). This is a byte limit, not a character count.
  • Links: at most 50 ordinary link occurrences, with URLs up to 2,048 characters.
  • Campaign dates: require at least a Start time or End time. Announcements and Updates can omit both. If both are set, End time must follow Start time. Use the editor’s UTC fields; dates written in Content do not populate those fields.
  • Check headings, lists, tables, and media in the preview. Use descriptive link labels, image descriptions, and video titles.
  • Remove placeholders and verify dates, eligibility, rewards, links, and terms.
  • Save your draft. If publishing fails, preserve your content and read the error before retrying.

​
Troubleshooting

For displaying published articles in your application, see the Blogpost API overview.