{"id":23116,"date":"2023-06-29T16:23:38","date_gmt":"2023-06-29T14:23:38","guid":{"rendered":"https:\/\/scrum-master.org\/faq-confluence-we-answer-all-your-questions-with-15-illustrated-tutorials\/"},"modified":"2024-02-26T13:41:05","modified_gmt":"2024-02-26T12:41:05","slug":"faq-confluence-we-answer-all-your-questions-with-15-illustrated-tutorials","status":"publish","type":"post","link":"https:\/\/scrum-master.org\/en\/faq-confluence-we-answer-all-your-questions-with-15-illustrated-tutorials\/","title":{"rendered":"FAQ Confluence: We Answer All Your Questions (With 15 Illustrated Tutorials)!"},"content":{"rendered":"\t\t
\n\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

Welcome to this FAQ dedicated to Confluence, an essential tool for every Scrum Master. We’ll take you step-by-step through Confluence’s various features in a series of tutorials. Let’s go !<\/p>\n\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\"\"\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I create a Confluence page?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To create a Confluence page, click on the “Create” button at the top left of the screen. Select the type of page you want to create, enter a title, and you can start adding content. It’s as simple as that.<\/p>\n<\/p>\n

\"screenshot
Button to create a new page<\/em><\/figcaption><\/figure><\/p>\n

You can also use the keyboard shortcut: c<\/strong><\/p>\n

To create a child page in a specific section of your confluence space. First, go to the target parent page, then click on the create button (or the c<\/strong> key on your keyboard). The newly created page will automatically be positioned below the parent page you were on.<\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t

\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I manage rights (creation, modification, deletion, viewing) for the entire Confluence area?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To add or remove rights to Confluence, you must have administrative rights. If you have these rights, then in the “Space tools” section (bottom left of your side panel), you’ll find a button called “Authorizations”.<\/p>\n

In “Authorizations” you can give more or less rights to each user or user group.<\/p>\n

\"image
Tuto: to modify access rights, click on the green and red icons in each column.<\/figcaption><\/figure><\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t
\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I apply read and edit restrictions to a page?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To apply restrictions to your Confluence page, go to the “…” menu at the top right of your page and select “Restrictions”.<\/p>\n

You can then define who can view or modify the page by user or user group.<\/p>\n

\"image
Restriction window on Confluence<\/em><\/figcaption><\/figure><\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t
\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I retrieve an old version of a Confluence page?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To retrieve an older version, go to the “…” menu at the top right of your page and select “Page history”. You can then choose the version you wish to restore.<\/p>\n

\"image
Confluence history page<\/em><\/figcaption><\/figure><\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t
\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I reorganize the pages in the Confluence tree structure?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To reorganize pages, go to your side panel, then to the “Space tools” menu, then select “Reorganize pages”.<\/p>\n

\"Image<\/p>\n<\/p>\n

You can then move the pages in the Confluence space tree:<\/strong><\/p>\n

\"Image<\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t

\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t How do I create a diagram on Confluence (Gliffy or Draw.io plugin)?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To create a diagram with the Gliffy or Draw.io plug-in, click on the “More” button in the page toolbar, select the “Gliffy Diagram” or Draw.io macro.<\/p>\n

\"screenshot
Macro for creating a Confluence diagram with Gliffy<\/em><\/figcaption><\/figure><\/p>\n

You will then be redirected to the plugin page. which will suggest schemas from an existing library.<\/p>\n

You can choose a template from a wide range of possibilities. In this example, I’ve taken a Kubernetes architecture diagram :<\/p>\n

\"image
Example of a diagram from Gliffy<\/em><\/figcaption><\/figure><\/p>\n

Once you’ve finished editing, click on “Save” and your diagram will appear on your Confluence page.<\/p>\n

Note: You can reuse a single Gliffy or Draw.io diagram on several Confluence pages. <\/p>\n

This allows the diagram to be updated in a single place. The update is performed automatically on all Confluence pages that call up this diagram.<\/p>\n

To do this, simply switch to edit mode on the confluence page containing the diagram you want to copy. Then select the diagram with the mouse and press CTRL+C followed by CTRL-V in the target Confluence page.<\/p><\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t

\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I import and view a PowerPoint or Excel file on a Confluence page?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To import a PowerPoint or Excel file, click on the “More” button in the toolbar of your page, select “File” and choose the file you wish to upload. You can also drag & drop the file onto the page to import it. Once this file has been uploaded, a preview will be visible directly on your page.<\/p>\n

In some Confluence versions (a little older) you can use the “Office Excel” or “Office Powerpoint” Macro to display a viewer of your file on the page.<\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t

\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I add a table of contents to a page?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To add the table of contents, simply insert the “Table of contents” macro in the desired position on your page<\/span>.<\/p>\n

\"tutorial
Contents” macro to display a table of contents on your page.<\/em><\/figcaption><\/figure><\/p>\n

Don’t forget to prioritize your page with titles and subtitles:<\/p>\n

\"image<\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t

\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I add a link from a Jira ticket to a Confluence page?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

Simply copy\/paste the Jira ticket url into the Confluence page editor.<\/p>\n

Here is the final result: <\/p>\n

\"screenshot<\/p>\n

If you go to this Jira ticket you will find a link back to this page: <\/p>\n

\"screenshot
Link to the Jira ticket documentation confluence page<\/em><\/figcaption><\/figure><\/p>\n

To find out more, read our tutorial on the 5 basic Jira actions<\/a>, available on our Blog.<\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t

\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I insert a simple table on Confluence?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To insert a table, click on the “Table” button in the toolbar of your page and choose the size of your table.<\/p>\n

\"image<\/p>\n

You get an empty table:<\/p>\n

\"3<\/p>\n

Clicking on a cell activates the table editing buttons on the toolbar of your Confluence page:<\/p>\n

\"image<\/p>\n

They allow you to edit the table (add\/delete rows or columns, copy\/cut\/paste rows or columns, etc.).<\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t

\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I display a list of child pages from a parent page?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To display child pages, insert the“Child page”<\/strong> macro on your parent page. This will automatically create a list of child pages linked to this page.<\/p>\n

\"Image
Children’s display” macro<\/em><\/figcaption><\/figure><\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t
\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I insert a table containing a list of Jira tickets?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To insert a list of Jira tickets, use the “Jira Issues” macro.<\/p>\n<\/p>\n

Simply enter the ticket numbers you wish to include or a JQL filter, and a list of Jira tickets will be automatically inserted on your page.<\/p><\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t

\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I include a Confluence page in another page?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To include a page, use the “Include page” macro. Simply enter the URL or title of the page you wish to include.<\/p>\n

\"image<\/p>\n<\/p>\n

The advantage of this approach is that existing pages can be reused in several other pages. So instead of editing the same table (or digram) several times on many different pages of your Confluence space. You can create a single page with this table (or diagram) and use this macro to call it up in all the other pages of your documentation.<\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t

\n\t\t\t\t\t

\n\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t<\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\tHow do I insert a well-formatted date on Confluence?<\/a>\n\t\t\t\t\t<\/h2>\n\t\t\t\t\t

To insert a date, simply type “\/\/” and a calendar will appear, allowing you to select a date. The date will be automatically formatted according to your regional settings.<\/p>\n

the result: \"image<\/p>\n<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t\t