Tutorial (all on one page)

Welcome to the tutorial on a page! This page contains all the topics from the tutorial.

On this page:

Using the menus

The image below gives an overview of the menus in Confluence. The menus give you access to all the available actions on your Confluence site.



Menu or option

Explanation

Browse menu

The 'Browse' menu gives access to wiki content such as pages, news items, etc, and allows you to browse the People Directory. If you are an administrator, the space and site administration options appear here too.

User menu

After you have logged in, your name will appear at top right of the screen. The 'User' menu appears when your cursor hovers over your name. The menu allows you to log out, access your user profile or view your editing history, personal labels and page watches. You can also retrieve drafts of pages you are editing.

Search box

Type into this box and press 'Enter' to search.

Edit button

The 'Edit' button allows you to edit the page.

Add menu

The 'Add' menu allows you to add things to a page or space.

Tools menu

The 'Tools' menu contains miscellaneous actions relating to the page.

Labels

This line shows labels (or tags) attached to the current page.

If your Confluence administrator has customised your Confluence site, then the menus may appear in different positions from those shown here.

If you are not logged in to Confluence, the 'Browse' menu and the 'User' menu will not appear. Instead, a 'Log In' link will appear.

Creating a space

Now that you have seen how the menus work, you are ready to start creating content in Confluence. Let's begin by adding a new space.

  1. Log in to Confluence, if you are not logged in already, by clicking the 'Log In' link at the top right of your Confluence screen.


  2. Right-click the 'Dashboard' link at the top left of your screen and open the link in a new browser window.


    (tick) Hint: Perform the rest of these instructions in the new browser window.

  3. Your Confluence Dashboard appears in the new window. On the left of the screen is a list of spaces. (The Demonstration Space will be one of those spaces.)


  4. Click the 'Create a space' link, located below the list.


  5. The 'Create Space' screen appears.


  6. In the 'Enter a Space Name' box, type a name for your new space. You may want to use your department name (e.g. 'IT', 'Finance' or 'Marketing') or a name that identifies the purpose of the space (e.g. 'Test Space').


  7. In the 'Enter a Space Key' box, type a short abbreviation of the space name (e.g. 'IT' or 'TEST').


  8. Under 'Who can use this space', all the boxes are ticked. You don't need to change anything at this time. For information about space permissions, please see the documentation.


  9. Under 'Choose Theme', the 'Default Theme' is selected. Keep the Default Theme for now. For information about themes, please see the documentation.


  10. Click the 'OK' button, located at the bottom of the screen.

  11. The home page of your new space appears.

What is a space?
A space is an area within Confluence, containing your wiki pages. You can think of each space as a sub-site, or mini-site, each with its own home page. You are looking at a space right now, called the Demonstration Space.

How many spaces should I create?
That depends on how you are planning to use Confluence. For example, if you are going to use Confluence for your intranet, you may want to create one space per department. If you want to use Confluence to write technical documentation, you could create one space per product.

Creating a page

{excerpt-include:Creating a lumbar pillow page|nopanel=true}

Adding content to a page

In the previous step, you created a page with some sample content. Now you will edit the page you have created and add some more content.

Opening the page for editing

  1. If you are not already viewing the page, go to the page you want to edit.

  2. Click the 'Edit' button on the page you want to edit. The button looks like this:


  3. Click an empty line in the large 'Rich Text' area, below the symbols 'B I U'.


  4. Press the 'Enter' key twice to create two new lines.

Inserting an image

  1. Click the 'Insert Image' icon on your page.


  2. The 'Insert Image' window will appear. Click the 'Browse' button.


  3. A popup window will appear. Select an image file from your computer or your network.

  4. In the 'Insert Image' window, click the 'Attach' button.

  5. Your image appears in the 'Insert Image' window. Click the image you have just attached, to ensure the file name appears in the 'Filename' box.


  6. Click the 'OK' button.

  7. Your selected image now appears on your page.

For more information about working with images, please see the documentation.

  1. Press the 'Enter' key twice to create two more new lines.

  2. Type the following sentence: 'What is a wiki?'.

  3. Select the word 'wiki', then click the 'Insert Link' icon on your page.


  4. The 'Link Properties' window will appear.


  5. In the 'Link' box, type 'http://www.atlassian.com/software/confluence/wiki.jsp'.

  6. Click the 'OK' button.

  7. The word 'wiki' is now a link.


For more information about working with links, please see the documentation.

Inserting a table

  1. Press the 'Enter' key twice to create two more new lines.

  2. Click the 'Insert Table' icon on your page.


  3. The 'Insert/Modify Table' window will appear. Click the 'OK' button.


  4. A table with two rows and two columns now appears on your page.


  5. Click in the column headings or other table cells to add your content to the table.


For more information about working with tables, please see the documentation.

Saving your changes

  1. Click the 'Save' button to save your page.

These instructions assume that you are using the Rich Text Editor.

If you are using Wiki Markup instead, please take a look at the documentation on working with images, working with links and working with tables.

Using the Dashboard

Now you will use the Dashboard to navigate to the new page and the new space that you created in previous steps of this tutorial.

  1. Right-click the 'Dashboard' link at the top left of your screen, and open the link in a new browser window.


    (tick) Hint: Perform the rest of these instructions in the new browser window.

  2. Your Confluence Dashboard appears in the new window.

  3. On the right of your Dashboard, under the heading 'Recently Updated', is a list of pages that have recently been added or edited. The page that you previously created will appear in this list (unless many other pages have been added or edited in the meantime).


    (tick) If your page doesn't appear in the list, skip this step and go to step 6.

  4. Click the name of the page that you previously created.

  5. Your page appears.

  6. Click the 'Dashboard' link at the top left of the screen. Your Confluence Dashboard appears again.

  7. On the left of your Dashboard is a list of spaces. Next to each space's name is the 'space' icon


  8. Click the name of the space that you previously created.

  9. The home page of your space appears.

The Dashboard is the home page of your Confluence wiki. The Dashboard contains a list of all the spaces within your wiki, as well as a list of recently updated content.

From the Dashboard, you can click any space's name to go to the space's home page.

To get to the Dashboard from anywhere within your wiki, click the 'Dashboard' link at the top left of your screen.

Updating your user profile

Now you will change your Confluence 'Full Name' (that is, the name by which you are known to other Confluence users) and profile picture (that is, the picture by which you are known to other Confluence users).

  1. Log in to Confluence, if you are not logged in already, by clicking the 'Log In' link at the top right of your Confluence screen.


  2. From the menu under your name, select 'Profile'.


  3. The 'Profile' view of your user profile appears.


  4. Click the 'Edit' link within the 'Personal' section on the right-hand-side of this view.

  5. In the 'Full Name' box, correct the spelling or type an alternative version of your name (e.g. a nickname).


  6. Click the 'Save' button.

  7. Your Full Name has now been changed.

    (tick) Hint: Changing your Full Name does not affect your login name (i.e. username).

  8. Still in the 'Profile' view, click 'Picture' at the left of the screen.


  9. Click the 'Browse' button, and select a photo of yourself (e.g. a GIF, JPG or PNG file) from your computer. Then click the 'Upload' button.


    (tick) If you don't have a suitable image file, select one of the 'Default Icons' instead. Here are some of them. You will find more on your Profile Picture screen.


  10. If the picture you selected is too big, you can now trim it. You will see your picture, with a highlighted box somewhere in the middle. Click and drag the box so that it covers the area of the picture you want. Pull the corners of the box in or out to select a larger or smaller area.


  11. Click the 'Save' button. Confluence will use the area of the picture which you have selected, and will resize it to the required size (48 pixels by 48 pixels).

  12. Your profile picture will appear next to any comments that you add and next to your updates on the Dashboard. Here's an example:

Your user profile contains your user details (e.g. your name, your picture and your password) and your Confluence user preferences (e.g. time zone and email format). For more information about updating your user profile, please see the documentation.

Adding a comment to a page

Now you will add a comment to the page that you previously created. (See Creating a page.)

  1. Go to your new page.
    (tick) For assistance on finding the page, please see Using the Dashboard earlier in the tutorial.

  2. Click the 'Add Comment' link at the bottom of the page.


  3. A 'Rich Text' area appears at the bottom of the page.


  4. Type a remark about the page.

  5. Click the 'Post' button.

  6. Your comment now appears at the bottom of the page, together with your name, the profile picture you added previously (see Updating your user profile) and the time your comment was made.


Posting comments in Confluence allows you and your colleagues to hold discussions within your wiki. You can often use the wiki instead of email, for example.

Creating a news item (blog post)

Now you will create a news item in your new space.

(tick) Hint: Perform these instructions in the new browser window which you opened previously. (See Creating a space).

  1. Under the 'Add' menu, select 'News'.


  2. A new, blank news item appears.


  3. Click in the box near the top of the screen, where the words 'New News' appear. The words 'New News' will disappear. Type a title for your news item (e.g. 'Latest update').


  4. Click in the large 'Rich Text' area, below the symbols 'B I U'. Type several sentences.


    (tick) Below the 'Rich Text' area are the page's Labels and Posting Day (which defaults to today). You don't need to change anything at this time.

  5. Click the 'Save' button.

  6. You can now see your newly created news item.

What is a news item?
Confluence news items are special pages found in the 'news' section of each space. They can be announcements, journal entries, status reports or any other timely information you would categorise as news. News items are also known as 'blog posts'.

For more information about working with news, please see the documentation.