Writing and publishing

Add content blocks

Build the body of your post from blocks: text, images and video, numbered steps, embeds, callouts and buttons. Learn what each block does and how to edit, move and delete blocks.

Guide · Tutorial · Writing

John Smith1 day ago · 4 min read · 2 views

The content of a post is a list of blocks. Each block is one piece: a stretch of text, an image, a set of steps, an embedded video and so on. You add blocks one at a time, and you can edit, move or remove them whenever you like.

In an empty post, Start writing, or add a block opens the Add a block list. It shows every block your post type allows, each with a short description. Pick one and a window opens to fill it in. Create adds the block; when you edit an existing block, the button is Save instead.

Text

Headings, paragraphs and lists. Use it for your main writing. The toolbar has Heading 2, Heading 3, Bold, Italic, Underline, Strikethrough, Inline code, Highlight, Quote, Bulleted list, Numbered list, Code block, Divider, Link, Undo and Redo.

To add a link, select Link, fill in Link text and Link/URL, then select Add. You can use as many Text blocks as you like, which makes it easy to put images or callouts between paragraphs.

Media

Upload an image or video. Choose Image or Video, then pick a file.

Images: JPG, PNG or WebP, at least 800px wide. Add Alt text (Describe the image for screen readers) and an optional Caption shown under the image.
Videos: MP4, MOV, AVI, WMV or FLV, no longer than 10 minutes, with an optional Caption.

Guide

Numbered steps. Use it for any procedure. Give the guide a Title, then add Steps. Each step has a Title and an optional Description. Select Add step for the next one.

Embed

YouTube, Instagram, Spotify and more. Paste a link in Link to embed. Under Paste a link from one of these: the window lists the supported sites, and the matching one is ticked once your link is recognised:

Video and social: YouTube, Vimeo, TikTok, Instagram, Threads, X, Reddit, Pinterest
Audio: Spotify, SoundCloud, Apple Music, Apple Podcasts
Code: CodePen, GitHub Gist

A Preview shows how it will look. Links from other sites show This link can't be embedded.

Callout and Button

Callout (Tip, note or warning) highlights a short message. Pick the Type (Tip, Note or Warning), add a Title and a Message. Keep it short, one or two sentences.

Button (A link readers can tap) adds a button that opens a web page. Enter the Button text and the Link, and check the Preview.

On a computer

Add a block on a computer

Open the block menuIn an empty post, select Start writing, or add a block. Once a post has blocks, use the plus button (Add a block below) between them to insert one at that spot. The Add a block menu opens right under it.

Pick a blockSelect the block you want.

Fill it inA window opens for that block. Enter its content and check the Preview where there is one.

Create itSelect Create at the bottom of the window. Close leaves without changes.

The Add a block menu listing Text, Media, Guide, Embed, Callout, Button and Subscribers only, each with a one-line description

The blocks available in an article

The Text block window with the formatting toolbar above a paragraph of sample text

The Embed window with a YouTube link pasted, YouTube ticked in the list of supported sites, and a preview of the video

Edit, move and delete blocks

Point at a block to show its toolbar:

Edit reopens the block's window.
The up and down arrows (Move up, Move down) shift the block one place.
The bin (Delete) asks Delete? first. Select Delete again to remove the block, or Cancel.
When there's more than one block, drag the grip handle at the left edge to move a block anywhere.

In a Guide block, a plus between steps inserts a new step at that spot.

A Text block in the post form with its toolbar showing Edit, Move up, Move down and Delete, and the grip handle on the left

On your phone

These steps are the same in the Boogir app and on boogir.com in your phone's browser.

Add a block on your phone

Open the Add a block sheetIn an empty post, tap Start writing, or add a block. Once a post has blocks, tap the small + under a block (Add a block below) to insert one right after it.

Pick a blockTap the block you want in the Add a block sheet.

Fill it inThe block's window opens full screen. Enter its content and check the Preview where there is one.

Create itTap Create at the top right. To leave without changes, tap the X at the top left.

The Add a block sheet on a phone listing Text, Media, Guide, Embed, Callout, Button and Subscribers only, each with a one-line description

The blocks available in an article

The Text block window full screen on a phone, with the X at the top left, Create at the top right, the formatting toolbar and a line of sample text

Edit, move and delete blocks

Tap a block to open a sheet named after its type, with:

Edit to reopen the block's window.
Add a block below to insert a new block right after it.
Move up and Move down to shift it one place (the first block has no Move up, the last no Move down).
Delete, which asks again with Delete and Cancel.

There is no dragging on a phone; use Move up and Move down to reorder.

The sheet that opens when you tap a Text block on a phone, with Edit, Add a block below and Delete

Tap a block to edit, add below, move or delete it

Blocks for specific types

Some blocks only appear for certain post types:

Story part and Verdict in stories. See Write a story with parts and a verdict.
Live video and Event update in events. See Run an event with updates and live video.
Subscribers only in articles, stories and events. See Add subscribers-only parts and earn.

PreviousChoose a post type: article, story, event or document Next in Writing and publishingWrite a story with parts and a verdict

2 views

Send in message

Report

Copy ID