Baselines for Confluence


Baselines for Confluence is a plugin that gives you a chance to define a 
base for your documents on Confluence.


To install Baselines for Confluence follow these steps:

  1. Log in as a admin user with the Confluence Administrators.
  2. Select Add-ons from the Administration menu at the top right of your screen. 


You can install the Add-On in two ways : Install the Add-On from Marketplace or Upload an Add-On.


Upload an Add-On :


  1. Click the Manage Add-ons link.
  2. Click the Upload Add-on link at the top right side of the page.  

    The 'Upload Add-on' dialog appears. (Picture 1)

Picture 1 

Install the Add-On from Marketplace :

    Log into your Confluence instance as an admin.

  1. Click    the admin dropdown and choose Atlassian Marketplace.
  2. Click Find new add-ons from the left-hand side of the page.
  3. Locate Baselines for Confluence via search. (Picture 2 )
  4. Click Try free to begin a new trial or Buy now to purchase a license for Baselines for Confluence.

  5. Enter your information and click Generate license when redirected to MyAtlassian.
  6. Click Apply license.   

Picture 2


Creating a Baseline

  • Open the "Baselines" tab in Space Administration section of your Confluence space.

  • Click "New" to create a Baseline
  • Enter a name for the baseline
  • Enter a baseline keyword, if any. (Further information about the use of Baseline Keyword is down in the document)
  • Select a date for the Baseline
    • For each page in the space, the newest version that has a date earlier than the given date will be included in the baseline.

  • Select the scope of the baselines
    • Include All Pages
      • This option includes all pages in the document space
    • Select Individual Pages
      • This option allows the user to select individual pages to be included in the baseline.
      • Mark the checkbox next to each page that you want to include in the baseline.
      • The menu icon next to the checkbox of each page opens a context menu which allows the user to select or deselect a page with all its subpages.

  • Click  "Create" to create the baseline.
  • Your new baselines will be displayed as part of the baseline list on the left.

Baseline Keyword

You can set a keyword to pick individual page versions from each page's history. When you enter a keyword, the plugin searches for the keyword in revision comment of each page version and includes the newest version (that is earlier than the selected date) that matches.

This capability can be used to filter out draft versions of a page. Since each "save" creates a new version, you can enter a specific word in document revision notes for major versions of pages and using the "Baseline Keyword" feature, you can make the plugin pick those versions from the page history.

If you do not use keywords in history notes, just leave the keyword empty.


Vieving Baseline Contents

  • Open the "Baselines" tab in Space Administration section of your Confluence space.
  • On the left column of the screen you will see the list of existing baselined created for that space. 
  • Click on one of the baseline to see the contents on the right.
  • Each row shows a page in the baseline with its title, full page location, the version of the page included in the baseline and the date of the page version.
  • You can click on the page title to navigate directly to the page version.

Deleting a Baseline

  • To delete a baseline, click on the garbage bin icon nextx to the baseline name in the list.

  • System will prompt you to confirm that you want to delete the baseline.
  • Click "Apply" if you are sure that you want to delete the baseline.
  • The baseline will then be permanently deleted and removed from the list.
  • Since the baseline contains only links to page versions, not actual pages themselves, deleting a baseline does not delete pages. Your pages will remain in their spaces.


3.3 Comparing Baselines 

  • To compare baseline contents, select exactly two baselines from the list and click compare.

  • The compare screen will display three separate lists of pages
    • Pages that are only included in the first selected baseline
    • Pages that are only included in the second selected baseline
    • Pages that are included in both baselines but have different versions in two baselines.
    • Pages that are included in both baselines with same versions will not be listed

  • Click on any page title to navigate directly to the page version.
  • Pages with different versions in selected baselines will show links to navigate to both versions.



Configure Security

Baselines for Confluence admin panel allows JIRA admins to define who can view and who can create Baselines.

To configure security:

  1. Select Baselines for Confluence Settings from the Confluence Administration menu.
  2. Select the user groups for view and edit permissions.
  3. Click Save Settings.

5. Support

 You can reach OBSS support team through or send an email to to get support.