> ## Content Index
> Fetch the complete content index at: https://notionsolutions.net/llms.txt
> Use this file to discover other available public pages before exploring further.

# Notion Callout Box: Add One, Style It, Pick the Right Use
- URL: https://notionsolutions.net/notion-callout/
- Published: 2026-11-22T09:00:00.000Z
- Updated: 2026-11-22T08:59:59.000Z
- Description: A callout is Notion's boxed-text block with an icon, made for tips, warnings and notes. Here's how to add one, turn text into one and back, get the gray-outline or colored look, what to put inside, and when a synced callout or a native button fits better.
- Author: Kevin Turner
- Tags: guide

**A callout in Notion is a boxed block of text with an icon, made for the tip, warning or note a reader shouldn't miss. Type `/callout` and press enter, or hover over a new line and choose + → Callout; then click the icon to change it and use ⋮⋮ → Color to color the box.** Notion has no separate warning or note block, so a warning is a callout with a warning icon and a color you keep for warnings.

For a warning, a tip or a step people must not skip, choose a colored callout with an icon that says the same thing as the color. For quiet notes and the instructions at the top of a template, choose the Default color, which gives a white box with a light gray outline in light mode. For an action teammates click, choose a native button; for a link that view-only visitors of a published page must click, choose a callout with linked text. I'd keep callouts rare on any page, because a box only draws the eye while it's the exception.

## How do you add a callout in Notion?

[Notion's help on styling a page](https://www.notion.com/help/customize-and-style-your-content?ref=notionsolutions.net) gives two ways to add one:

1. Hover over a new line, click **+** to the left of the block and choose **Callout**.
2. Type `/callout` and press enter.

The box appears with an icon already in place, and you type straight into it. To move it, hover over the callout and drag the ⋮⋮ handle. Blue guides show where the block will land, and a callout can sit in a column beside other blocks.

[![Notion slash-command menu with Callout and Callout Turn into results above the typed callout command](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-callout-slash-20261119.webp)](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-callout-slash-20261119.webp?ref=notionsolutions.net)

Choose Callout to add a new box; Callout · Turn into converts the current text block.

## How do you turn text into a callout, and back?

Hover over the paragraph, click ⋮⋮ and choose **Turn into** → **Callout**. Notion's [block basics guide](https://www.notion.com/help/guides/block-basics-build-the-foundation-for-your-teams-pages?ref=notionsolutions.net) lists callout among the blocks you can convert text into, and the same menu works in reverse: ⋮⋮ → **Turn into** → **Text** takes the box away and leaves a plain paragraph. If the callout holds lists or headings, look over the page afterward to see where they ended up.

From the keyboard there are two routes. Type `/turn` at the beginning or end of a block and pick from the list that pops up, or select the block, press cmd/ctrl + / and choose the block type you want. Notion's [keyboard shortcuts page](https://www.notion.com/help/keyboard-shortcuts?ref=notionsolutions.net) documents both, and it has no dedicated callout shortcut. [super.so's callout guide](https://super.so/blog/notion-callout-block-the-complete-guide-2024?ref=notionsolutions.net), published by a company that sells a Notion website builder, says the same in its FAQ and recommends typing `/callout` instead. Our [Notion keyboard shortcuts guide](https://notionsolutions.net/notion-keyboard-shortcuts/) has the rest of the list, including the `/color` and `/default` commands.

## How do you delete or duplicate a callout?

Hover over the callout, click ⋮⋮ and choose **Delete** or **Duplicate**. Notion's [editing basics](https://www.notion.com/help/writing-and-editing-basics?ref=notionsolutions.net) describe Duplicate as an exact copy of the block, which makes it the easy way to reuse a styled warning box on the same page. Delete takes the whole block off the page. If you want the box gone but the words kept, use **Turn into** → **Text** instead.

For a warning you add often, I'd make a button that inserts an independent copy, so editing one note won't change the others. Type **/** and choose **Button**, then select **New action → Insert blocks**. Add a **/callout** inside the action, set its icon, color and starting text, and select **Done**. Notion's [Insert blocks action](https://www.notion.com/help/buttons?ref=notionsolutions.net) can place the copy above or below the button, or at the top or bottom of the page. Put the button where you create those notes; use a synced block when every copy should change together.

[![Notion block action menu with Delete and Duplicate.](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-callout-actions-desktop-20261120.webp)](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-callout-actions-desktop-20261120.webp?ref=notionsolutions.net)

Duplicate copies the entire block; Delete removes the selected callout.

## How do you change or remove a callout's icon?

Every callout comes with an icon. Click it and choose a new one, or click it and select **Remove** for a box with no icon. You can also upload your own image, ideally 280 x 280 pixels, or paste a link to an image. If nothing fits, click 🔀 for random options until one does.

Pick icons by meaning, not decoration. The icon is what still marks a warning as a warning for someone who can't tell the colors apart, so I'd settle on one icon per kind of callout and reuse it across the workspace. A page's own icon, the one at the top left of the page and beside its name in the sidebar, is a separate setting.

## How do you change a callout's color or get a gray border?

Hover over the callout, click ⋮⋮, select **Color** and choose from the background color menu. That colors the whole block; the same menu also changes the color of the text inside. Notion's styling help gives a keyboard route too: press cmd/ctrl + / and type the name of the color.

The gray border has a short answer. In light mode, choose **Default** in that menu and the block turns white with a light gray outline. Picking a non-black text color turns the box white with the same outline and colors the words as well. Notion's help describes no separate border setting, so those two choices are how you get the outlined look.

[![Notion background-color submenu with Default Background and gray, brown, orange, yellow, green, blue and purple choices](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-callout-color-20261119.webp)](https://storage.ghost.io/c/5c/30/5c30c46b-86a3-4d20-984f-4f6ae8ad1ed2/content/images/2026/11/notion-callout-color-20261119.webp?ref=notionsolutions.net)

Use the background-color choices for the whole box. Default gives the quiet outlined look in light mode.

For a warning, Notion's [list of basic blocks](https://www.notion.com/help/guides/types-of-content-blocks?ref=notionsolutions.net) runs from page, to-do list and headings through toggle list, quote and divider to callout, and a warning or note is not a block type of its own. Build the warning yourself from three parts: a warning icon, a background color you use only for warnings, and a plain first word such as “Warning:” so the box reads correctly without the color. Text highlights and page backgrounds are separate settings from the callout's own color.

## What can you put inside a callout?

A callout can hold other blocks, such as bulleted lists and headings, and you can drag them around inside it. The developer docs agree: [Notion's block reference](https://developers.notion.com/reference/block?ref=notionsolutions.net) lists callout among the block types that support child blocks.

Headings are the part to get right. A heading inside a callout appears in the page's table of contents, so when the boxed text is a real section, give it a real heading block. Bold text doesn't count: a use-case guide that styles callouts as headings with bold text notes that those labels stay out of the table of contents. That's fine for a decorative label and wrong for a section people need to find.

Two more pieces fit well inside a callout:

- **Line breaks.** Press shift + enter for a line break within the same text, so a two-line note stays one block.
- **A toggle.** Put optional detail in a toggle inside the callout and keep the sentence people must read in the callout's own text, where nobody has to click to see it. Our [guide to Notion toggles](https://notionsolutions.net/notion-toggle/) covers toggle lists and toggle headings.

Some layouts go further. [A use-case guide to callout blocks](https://theorganizednotebook.com/blogs/blog/best-use-cases-for-callout-blocks-in-notion-easy-tips-tricks?ref=notionsolutions.net) suggests nesting one callout inside another, adding columns inside a callout to line up links or buttons at the top of a page, and embedding database views inside colored callouts to frame them. Notion's help doesn't walk through these, so build one on a spare page and check it on desktop and on your phone before you repeat it across a workspace.

## When should you use a callout?

Use one when a single piece of a page has to stand apart from everything around it. These are the jobs callouts do well, and the one case where a button beats them.

### A tip or warning box

This is the job Notion's own help names first: drawing attention to a warning or a tip. Keep one meaning per color across the workspace and pair each color with its icon. If every callout on a page is red, none of them reads as a warning.

### Instructions at the top of a template

A Default callout at the top of a template tells the person filling it in what goes where, without shouting. If the instructions run long enough to be a section, put a heading inside so they show in the table of contents. On a procedure page, a short “How to use this page” box above the steps does the same job; our guide to [what goes on a Notion SOP page](https://notionsolutions.net/notion-sop/) covers the rest of that page.

### A navigation box

Put links to the pages people open most into one callout. Notion's help on [links and backlinks](https://www.notion.com/help/create-links-and-backlinks?ref=notionsolutions.net) gives three ways to link a page: type `@` and the page name, type `[[` and the page name, or type `/link` for a Link to page block. The difference shows up in the sidebar. A Link to page block makes the linked page appear under the current page in the sidebar, like a subpage, while an @-mention works more like a hyperlink and doesn't. For a navigation box I'd use @-mentions, so the sidebar keeps the structure you gave it.

To show the same box on several pages, sync it, as the use-case guide does with its navigation callouts. Notion's [synced blocks help](https://www.notion.com/help/synced-blocks?ref=notionsolutions.net) gives the steps: click ⋮⋮ next to the callout, choose **Turn into** → **Synced block**, then select the copy icon and paste the block wherever you want it. Change one copy and the change appears in every other place the block lives.

The catch is access. People who can't open the page holding the original block can't see a synced block's contents; they can request access to that page instead. So a client who can't open the page where you built the original won't see what's in the box. The sync keeps every copy in step; deciding who can open the original page is still your call. Our guide to [synced block permissions](https://notionsolutions.net/notion-synced-block-permissions/) walks through that check.

Before removing a synced copy, hover over it and choose **••• → Unsync** to make it independent. Notion warns that [when a synced block has more than 10 copies, deleting the original or choosing Unsync all removes every copy](https://www.notion.com/help/synced-blocks?ref=notionsolutions.net); Undo won't restore them. Unsync the copies one at a time if you need to keep them.

### A link box or a button

The use-case guide makes the point that callouts with linked text were the way to build clickable links before Notion had buttons, and that they still suit a page that wants its own look. Native buttons cover that job: type `/`, choose **Button** and give it the **Open page or URL** action. Notion's [buttons help](https://www.notion.com/help/buttons?ref=notionsolutions.net) attaches conditions, though. A person needs Full access or Can edit on the page to click a button, certain button actions are only available on paid plans, and when a button opens a page, the person clicking needs access to view that page.

Those conditions decide it. For an action your teammates click, use a native button; our [Notion button guide](https://notionsolutions.net/notion-button/) covers the actions. For a link that view-only visitors must click on a page you share through **Share** → **Publish** tab → **Publish**, use a callout with linked text, because button clicks are limited to people with Full access or Can edit. Our guide to [publishing a Notion website](https://notionsolutions.net/notion-website/) covers the rest of that setup.

### A focus line on a dashboard

A single callout at the top of a dashboard can hold the week's one priority, so it's the first thing you see when the page opens. Our [personal dashboard guide](https://notionsolutions.net/notion-personal-dashboard/) uses exactly that as its focus line. Keep it to one sentence and rewrite it every week; a focus line nobody updates turns into wallpaper.

### A sticky note with checkboxes

The use-case guide's last idea is a digital sticky note: a colored callout with a to-do list inside. It works for a short checklist that belongs to one page, such as the checks to run before you send a page to a client. For tasks that need an owner and a due date, I'd keep them in a task database, where those details are properties rather than words in a box.

## How do callouts work on a phone?

The mobile app has no `/` commands and no icons that appear on hover. According to the same editing basics page, everything is created from the editing toolbar above the keyboard: tap **+** there for the full menu of block types and pick Callout. That toolbar also handles text color and highlight, and deleting or duplicating a block. Notion's [mobile help](https://www.notion.com/help/notion-for-mobile?ref=notionsolutions.net) adds that the ••• and + icons stay visible on a phone instead of appearing on hover.

Layouts are where phones change things. Notion's [columns help](https://www.notion.com/help/columns-headings-and-dividers?ref=notionsolutions.net) says columns are available on tablet but not mobile: on a phone, the content of a right-hand column sits under the content of the left one. A row of side-by-side callouts becomes a stack, so I'd keep that layout for desktop dashboards and put the box that matters most in the left column, since that's the one a phone shows first.

## What happens to callouts in Markdown export and the API?

Markdown has no callout, so Notion writes it as HTML. Its [export help](https://www.notion.com/help/export-your-content?ref=notionsolutions.net) says callout blocks are exported as HTML because there is no Markdown equivalent. To export, click ••• at the top right of the page, choose **Export**, then pick **Markdown & CSV** from the dropdown. A tool that doesn't render HTML will show the callout as tags rather than a box, so open the file where it's headed before you move a page full of callouts.

For developers, the block reference describes a callout as rich text plus an icon and a color, and the icon can be an emoji, a custom emoji, a native icon or a file.

## What does Notion document for each callout use?

Every use above comes down to the same block with different settings, so the useful comparison is what Notion documents for each one and where it trips people up. Rows marked as a use-case guide's technique come from that guide, not from Notion's help.

__Callout uses by setup, documented behavior and pitfalls.__
| Use                               | How                                                                                          | What Notion documents                                                                                                                                                         | Watch out                                                                                                                 | Best for                                                     |
| --------------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| Tip or warning box                | /callout and enter, or + → Callout; click the icon; ⋮⋮ → Color                               | Callouts exist to draw attention to a warning or a tip; the basic blocks include callout and no separate warning or note block                                                | Color alone doesn't say “warning” to everyone; pair it with an icon and a plain first word                                | Warnings, tips, disclaimers                                  |
| Plain box with a gray outline     | ⋮⋮ → Color → Default, or a non-black text color                                              | In light mode, both turn the block white with a light gray outline                                                                                                            | A non-black text color recolors the words too                                                                             | Quiet notes, instructions at the top of a template           |
| Section inside a callout          | Add a heading block inside the callout                                                       | Headings inside a callout appear in the page's table of contents                                                                                                              | Bold text isn't a heading; a use-case guide notes bold-text callout headings stay out of the table of contents            | Boxed sections people should find from the table of contents |
| Navigation box                    | Page links with @, \[\[ or /link; reuse with ⋮⋮ → Turn into → Synced block, copy icon, paste | A Link to page block also lists the linked page under the current page in the sidebar; people without access to the original block's page can't see a synced block's contents | Check who can open the original page before you sync a client-facing box                                                  | Dashboards, wikis, client pages                              |
| Link box or action                | Linked text in a callout, or / → Button with Open page or URL                                | Full access or Can edit is needed to create, edit and click buttons; certain button actions are paid-only                                                                     | View-only visitors of a published page can't click a button, so give them a linked callout                                | Button for teammates who edit; linked callout for viewers    |
| Callouts in columns               | Drag a callout by ⋮⋮ beside another block until the blue guide shows                         | Callouts can sit in a column; columns are available on tablet but not mobile, where the right column lands under the left                                                     | Side-by-side callouts become a stack on a phone; columns inside a callout are a use-case guide's technique                | Desktop dashboards                                           |
| Nested content                    | Drag lists, headings or a toggle into the callout                                            | A callout can contain bullets and headings; the API lists callout among blocks with child blocks                                                                              | Nested callouts and database views inside colored callouts are a use-case guide's techniques; check them on your own page | Sticky-note checklists, a colored frame around a view        |
| Turn text into a callout, or back | /turn at the start or end of a block, ⋮⋮ → Turn into, or cmd/ctrl + /                        | The shortcut list has no callout shortcut; super.so's FAQ says the same                                                                                                       | ⋮⋮ → Delete removes the whole block; Turn into → Text keeps the words                                                     | Cleaning up older pages                                      |
| Export and Markdown               | ••• → Export → Markdown & CSV                                                                | Markdown export writes callouts as HTML; the API callout has rich text, an icon and a color                                                                                   | A tool that doesn't render HTML shows the callout as tags                                                                 | Docs that leave Notion                                       |

Read across the rows and one pattern stands out: every tip box, warning, note and gray-outline box on a Notion page is the same block with a different icon and color. The styling is the easy part. The documented limits are what change how you build: headings in a callout reach the table of contents and bold text doesn't, a synced navigation box hides its contents from anyone who can't open the original, view-only visitors can't click buttons, columns stack on phones, and Markdown export turns a callout into HTML.

## Which callout should you use?

**My verdict: use a callout for the one thing on a page a reader must not miss, whether that's a warning, a tip or the instructions at the top of a template.** Give each color one meaning across your workspace and always pair it with an icon, so a warning still reads as a warning without the color. When the boxed text is a section, put a real heading inside it so the table of contents picks it up. For an action teammates click, use a native button; for a link view-only visitors must click on a published page, use a linked callout. Sync a navigation callout only after checking that everyone who sees the copies can open the original page, and keep side-by-side callouts for desktop dashboards, because columns stack on phones.

To try it on a page you already use:

1. Find the most important instruction on the page, type `/turn` at the start of it and choose Callout.
2. Click the icon and pick one that says what the box is for.
3. Click ⋮⋮ → **Color** and choose one background color, or Default for a quiet box.
4. If the box is a section, drag a heading block into it.
5. Check the page's table of contents, then open the page on your phone.

If the box still stands out on the phone and its heading shows in the table of contents, use that icon and color for the same kind of callout everywhere else.