Add formatting to your page

Create attractive, engaging pages in Confluence using the formatting tools. In addition to your standard formatting options, like bold and italics, you can also change page layouts in Confluence, add dynamic tables of contents, add and assign tasks, and display images, gifs, videos, and other multimedia. 

On this page:


The layout of your pages can have a big influence on how they're read, and what visual impact your content has. Narrower columns, for example, optimize for readability, with around 50-75 characters per line, but wider page widths work better for displaying tabular data.

You can create different layouts in Confluence with the section tool, giving each section a different column configuration. 

Screenshot: Editor view of a page showing two sections with different column configurations. 

To use sections, choose the Page Layout   button in the toolbar. This will cause the Page Layout toolbar to appear.

1. Add a section: Adds a new section below your current content, with the boundaries of the section(s) indicated by dotted lines (the dotted lines aren't visible when you view the page).

2. Column layouts: Changes the column layout of the section in which you have your cursor. Content doesn't get lost when you change the column layout; additional columns are added to the right, and when you change to a layout with fewer columns, the content moves to the left. 

3. Move a section: Moves the section you have your cursor in, along with all the content in it, above or below other sections on the page. 

4. Remove section: Removes the section you had your cursor in, deleting that section and all of its contents.

Very wide tables:

The width of each column is set to a percentage of the page width, so your columns will grow or shrink as your page size changes. If a column includes an item that's too wide for it, you'll see a horizontal scroll bar when viewing the page. If you want to avoid this, set your images to original size, which scales them to fit. 


Confluence has all the standard formatting options you'd see in any other word processing software. Play around with italics, bold, and underline to add emphasis to your text, or change the color, indentation, or alignment. In addition to those, here are some other formatting tools you can use:

  • Emphasize a quote by changing the style of that text from paragraph to quote.

Quotes look like this.

  • Separate sections of text using the horizontal line divider. You can find this under the  insert more menu

  • Use the date picker by typing //and picking your date.

  • Mention someone by using @ and their name. This will look like this: Desiree Conceicao. The user you mention will receive a notification, so you can use this to let them know to read the page, or to draw their attention to a specific comment.

  • Wrap text around your images by selecting an image, and clicking any of the align buttons twice. The first time will change the alignment, and the second time will cause the text to wrap around the image. 

  • Use the code block macro to display source code in your page with syntax highlighting.

<div style="color: green">
	<p> This page needs more cats.</p>

  • Too much info? If you want a page to display extra info for the people who need it, without cluttering it up for everyone else, try using expands.
Click here to expand...

You can find expands under the macro browser. Go to the insert more menu > other macros > expands.

  • Call attention to information using info, tip, warning, or note macros. These create a colored box surrounding your text. 

  • Alternatively, use a panel macro. You can change the border, title, and background of the panel for a variety of looks. 
  • Add tasks by using the  button and mentioning another user. Whoever you first mention on that line is assigned the task. Assigning someone a task looks like this: 
    These tasks will show up on Giles Brunning's tasks list under his profile, and he can tick them off as he does them. The due dates will turn red if they become overdue. He can also filter them by date, completion, and whether they were assigned to him or created by him from here. If he'd prefer to see these on another page, he can also use the Task Report Macro.
  • Use the Table of Contents Macro to generate a list of links pointing to the headings on the page. The list of links will appear wherever you add the macro, and will automatically update each time someone changes the wording of a heading.
  • Add emojis, symbols, or special characters. (awesome)(star). See the full list of here


To add a table, choose  Insert table in the toolbar, then click a cell in the drop-down to set the number of columns and rows. 

Edit your table

To make changes to your table, click inside any of the cells. This will cause the table tools to appear in the toolbar. 

Here's a summary of the table tools:

Column width modes

  • Responsive – The table will expand as you add content, and you can drag to resize the columns. It'll also resize itself to fit the page-viewer's window size (within reason).
  • Fixed width – Drag column borders to set width. Columns appear at your set size, regardless of content and window size.


  • Insert rows before or after the current row, or delete the current row
  • Cut, copy, and paste the current row
  • Mark a row as a header row (shaded with bold text); double click this to remove the header row.


  • Insert columns before or after the current column, or delete the current column
  • Cut, copy, and paste the current column
  • Mark a column as a header column (shaded with bold text); double click this to remove the header row


  • Merge selected cells or split selected cells
  • Change cell color


  • Remove a table
  • Insert a numbering column to automatically number each row

When viewing a table on a page, you can sort it by clicking the sort icons in the header row.

(info) Tables do not nest; that is, you cannot have a table within a list, block quotes, or another table.

To insert a link on a page:

  1. Select some text or an image, or position your cursor where you want to insert the link.
  2. Choose Link on the toolbar or use the keyboard shortcut Ctrl+K.
  3. Select a page, blog post or attachment, or enter an external URL (see Links and Anchors for how to link to particular types of content).
  4. Enter or modify the link text. This is the text that will appear on the page. If this field is left blank, the page name or URL will be used as the link text.
  5. Choose Insert.

You can also paste a URL directly onto your page. Confluence will automatically create the link, and if the URL is from a page on the current site, the page name will be set as the link text.

Images, videos, and gifs

If a photo is worth a thousand words, how many words is a gif worth?

Add an image or gif onto a Confluence page by choosing> Files and Images. Either upload your image or gif into Confluence, or display an image from another web page using its URL.  You can select the pixel size of your images, or choose original so that it fits to scale. If your image is too big for the column or page, it'll result in a horizontal scroll. 

Drag and drop:

Drag files, like images, multimedia, Office files and PDFs, from your computer and drop them directly into the editor. The contents of the file will be embedded into the page or blog post.


You can also display movies, animations and videos, and embed audio files on your Confluence page. Confluence supports Adobe Flash, MP3, MP4, and various other movie formats. Upload these using the multimedia macro

Social video and image sharing 

The Widget connector macro displays live content from YouTube, Vimeo, Flickr, and other sites. For Youtube and Vimeo links, you can paste the URL onto your page and it will automatically convert into a playable video. 

Browse through the full list of macros to see what other cool things, from statuses to roadmaps, you can add to your Confluence page. 

Last modified on Aug 31, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.