How to Add Blocks to a Page in Confluence

What Are Blocks in Confluence?

If you’ve ever stared at a blank Confluence page wondering why it looks like a wall of text — blocks are the answer.

Blocks are the building units of every Confluence page. They let you structure content visually: add headings, callout boxes, tables, code snippets, images, dividers, and a lot more — all without touching a single line of HTML or markdown.

According to Atlassian’s own data, teams that use structured Confluence pages report up to 30% faster onboarding for new team members. Organized documentation isn’t a “nice to have” — it directly affects how fast your team moves.

Here’s exactly how to add blocks to any Confluence page, step by step.

How to Open the Block Menu in Confluence

Before you can add anything, you need to know where to look.

Confluence uses an editor interface that’s built around blocks. Here’s how to access them:

Method 1 — The Slash Command (fastest)

1. Open or create a Confluence page
2. Click anywhere in the editor body
3. Type / (forward slash)
4. A dropdown menu appears showing all available block types
5. Start typing the name of the block you want (e.g., /table, /image, /info)
6. Press Enter to insert it

This is by far the fastest method. Most power users live by the slash command.

Method 2 — The Toolbar

1. Click into the editor
2. Look at the top toolbar
3. Click the + icon (Insert content)
4. Browse and select the block type you need

Method 3 — The + Button on Hover

1. Hover your cursor to the left of any existing block
2. A + button appears in the margin
3. Click it to insert a new block directly above or below

All three methods work in both Confluence Cloud and Confluence Data Center (Server). The slash command approach is available in the new editor — if you’re on the legacy editor, use the toolbar instead.

The Most Useful Blocks and How to Add Them

Here’s a breakdown of the blocks you’ll actually use day-to-day, and exactly how to get them on the page.

Text and Heading Blocks

Type /heading1, /heading2, or /heading3 to create section headers. These form the navigable skeleton of your page.

A study by Nielsen Norman Group found that users read web content in an F-pattern — they skim headings first. Structured headings make your pages scannable instead of skippable.

How to add:

• Type /heading1 → Press Enter → Start typing your section title
• Or highlight existing text → Click the format dropdown in the toolbar → Choose H1, H2, or H3

Table Blocks

Tables are one of the most-used blocks in Confluence — especially for comparison docs, sprint planning, and data tracking.

How to add:

1. Type /table and press Enter
2. A 3×3 grid appears by default
3. Click any cell to edit
4. Use Tab to move between cells
5. Right-click any row or column header to add more rows/columns

Atlassian reports that tables are among the top 5 most-inserted content types in Confluence pages globally.

Info, Warning, and Note Panels (Callout Blocks)

These colored panel blocks are perfect for surfacing important information that would otherwise get buried in paragraphs.

There are four panel types:

• Info (blue) — general notes
• Warning (yellow) — caution points
• Error (red) — critical issues
• Success (green) — completed steps or positive outcomes

How to add:

• Type /info, /warning, /note, or /success → Press Enter
• Or: Type /panel and select your preferred color from the options

Image Blocks

According to research from MIT, the human brain processes images 60,000 times faster than text. Adding visuals to your Confluence pages isn’t decoration — it’s communication strategy.

How to add:

1. Type /image → Press Enter
2. Choose from three options:
   • Upload — drag and drop or browse your files
   • Link — paste an external image URL
   • Attach — pull from existing page attachments
3. Click the image after inserting to resize, add a caption, or set alignment

Code Blocks

If your team works with technical documentation, code blocks are non-negotiable. They preserve formatting, enable syntax highlighting, and make copy-paste actually reliable.

How to add:

• Type /code → Press Enter
• Select the programming language from the dropdown (supports Python, JavaScript, SQL, Bash, and 30+ others)
• Paste or type your code directly into the block

Divider Blocks

A horizontal rule divider is a simple but powerful tool for visually separating page sections.

How to add:

• Type /divider or /horizontal rule → Press Enter

Expand (Accordion) Blocks

When a page has a lot of content, expand blocks let you hide sections behind a clickable toggle — keeping pages clean without removing information.

How to add:

• Type /expand → Press Enter
• Add a title for the collapsed section
• Click inside the expand block to add content inside it

Task List Blocks

Confluence pages can double as lightweight task trackers. Task list blocks let you assign action items directly on the page — with checkbox completion tracking.

How to add:

• Type /task list → Press Enter
• Each line becomes a checkable task
• Type @username to assign the task to a team member

Embedded Media Blocks (Video, PDF, and More)

Confluence supports embedding content from over 200 applications through its macro library — including YouTube videos, Google Docs, Jira boards, Figma files, and more.

How to add:

• Type / and search for the app name (e.g., /YouTube, /Jira, /Figma)
• Follow the authentication or URL prompt
• The content embeds live inside the page

How to Move, Rearrange, and Delete Blocks

Adding blocks is only half the job. Here’s how to manage them:

Move a block:

• Hover over the block until the drag handle (⠿) appears on the left
• Click and drag to a new position on the page

Delete a block:

• Click on the block to select it
• Press Backspace or Delete on an empty block
• Or right-click → Delete

Duplicate a block:

• Right-click any block
• Select Copy — then paste with Ctrl+V / Cmd+V wherever you need it

Multi-Column Layouts: Placing Blocks Side by Side

By default, Confluence stacks blocks vertically. But you can create side-by-side layouts using the Layouts feature.

How to add a multi-column layout:

1. Type /layouts → Press Enter
2. Choose a layout option: two columns, three columns, left sidebar, right sidebar
3. Click inside each column section and add any blocks you want
4. Blocks inside layout columns behave identically to regular blocks

Teams that use multi-column layouts reduce average page scroll length by up to 40%, according to internal usability tests reported by enterprise Confluence users on the Atlassian Community forums.

Confluence Block Permissions and Restrictions

Not every user on a space can edit all blocks. Here’s what controls that:

• Page-level restrictions: Admins can lock specific pages to “view only” for certain user groups — meaning those users can see blocks but not edit them
• Space-level permissions: Determined by your Confluence admin; controls who can create, edit, or delete content in a space
• Inline comments on blocks: Any user with comment permissions can leave inline comments on specific blocks — useful for review workflows

If you can’t insert blocks on a page, check with your space admin — you likely have view-only access.

Common Mistakes When Adding Blocks (and How to Avoid Them)

Overloading pages with too many block types. A page with 12 different block styles looks chaotic. Stick to 3–4 block types per page to maintain visual consistency.

Skipping headings. Pages without H2 or H3 headings are impossible to navigate. Confluence’s “Page Tree” and in-page navigation anchor links only work when you use heading blocks.

Embedding instead of linking large files. Embedding a 50MB video directly into a Confluence page slows load time significantly. Use an external video host (YouTube, Loom, Vimeo) and embed the link instead.

Forgetting to save. Confluence auto-saves drafts, but it does not publish automatically. Always click Publish (or Update) when your edits are final. Drafts are only visible to editors — not the rest of your team.

Confluence vs. Other Documentation Tools: Why Teams Still Choose It

Despite competition from Notion, Coda, and Google Sites, Confluence remains the #1 enterprise wiki platform globally, used by over 75,000 companies according to Atlassian’s 2024 annual report.

Why? A few key reasons:

• Deep Jira integration (critical for software and product teams)
• Robust space and permission management at scale
• 3,000+ app integrations via the Atlassian Marketplace
• Enterprise-grade compliance (SOC 2, GDPR, ISO 27001)

That said, Confluence is a tool for documenting what already exists. It won’t help you generate new pipeline, new conversations, or new business opportunities. For that, you need a different system entirely.

From Documentation to Pipeline: What Confluence Can’t Do

Here’s a pattern that plays out across thousands of teams:

Your Confluence is clean, organized, beautifully structured. Every process is documented. Every SOP has its own page. And yet — your outbound pipeline is still inconsistent. Meetings aren’t getting booked. The people who need to know about what you do still haven’t heard from you.

That’s because internal documentation and external lead generation are completely different engines.

Confluence organizes your knowledge. Salesso creates your pipeline.

At Salesso, we run complete outbound lead generation programs across cold LinkedIn, cold email, and cold calling — for teams that are serious about filling their calendars with qualified meetings. We handle everything: targeting, campaign design, messaging, and scaling. Our clients consistently see 15–25% response rates, compared to the industry average of 1–5% for cold outreach done without a system.

If your team has the documentation locked down but the pipeline still isn’t where it needs to be — book a strategy meeting and let’s fix that.