Enable and disable project pages

The project pages feature helps your team keep track of all documentation created in Confluence Cloud. Set up a space in Confluence and link it to your Jira Software project to help your team easily see and access all project documentation from Jira Software, without having to go to Confluence.

Enable and disable project pages

Team-managed or Company-managed projects

  1. Navigate to your team-managed or company-managed software project.

  2. Go to Project Settings Features.

  3. Enable the Project pages or Pages feature.

A new menu item, Project pages, will be added to the project menu.

Set up project pages for your Jira Software project

Step 1: Sign up for Confluence

To start creating documentation for your project, you'll need to sign up for Confluence Cloud. You can sign up for a trial from your Jira Software project:

  1. Navigate to your Jira Software project.

  2. In the project menu, select Project pages.

  3. Select Create your first page and you'll be prompted to set up a Confluence Cloud trial.

If you sign up for Confluence via project pages, a space will be automatically created and connected to your project for you.

Step 2: Create a Confluence space for your team

Confluence spaces are like Jira projects — they are used by your team to store information. But while Jira projects store issues, Confluence spaces store pages.

If you signed up to Confluence via project pages, your space should have already been created for you.

To create a new Confluence space from project pages in Jira Software, you’ll need to:

  1. Navigate to your software project.

  2. In the project menu, select Project pages.

  3. Select Connect to Confluence.

  4. Select Create a new space to create a new space that will be automatically connected your Jira Software project.

Step 3: Connect your team's existing Confluence space to your team's Jira project

To connect an existing Confluence space from project pages in Jira Software, you’ll need to:

  1. Navigate to yourJira Software project.

  2. In the project menu, select Project pages.

  3. Select Connect to Confluence.

  4. Select a space from the dropdown menu.

  5. Select Connect and your space will be connected to your Jira Software project.

Image of the connect a space dialog box

Create a page

  1. Navigate to your software project.

  2. In the project menu, select Project pages.

  3. Select one of the templates if you want help getting started, or select Blank page to create a page from scratch. Whichever option you select, you'll be taken to Confluence to create your page.

Image of project pages list and buttons
  1. Project pages list: The pages you create in your team's Confluence space will be listed here for easy access.

  2. Templates: Create a new Confluence page with pre-filled content to help you create documentation for your project.

Connect to a different Confluence space or page

Project pages can only be connected to one space or page at a time. When you connect a space or page, all its children pages will be visible in project pages. If a page is restricted in Confluence, the same permission settings apply in project pages.

To change which space project pages is connected to:

  1. Navigate to your Jira Software project.

  2. In the project menu, select project pages.

  3. Select the Connect to different space or page icon (represented by two arrows in the top right).

  4. Select an existing space or page from the dropdown menu. You can also create a new space and connect to it by selecting Create new space.

  5. Select Connect and your selected space or page will be connected to your Jira Software project.

Image highlighting the location of the switch space icon in project pages.

Understanding how users get access to Confluence via project pages

Once you have project pages set up, Jira users will be able to see the Project pages button in the side navigation. If a user selected project pages and they don’t have access to the connected Confluence space, they’ll see a prompt to use project pages.

If the user is on an approved domain, they can select the “Join Confluence” button to start using project pages right away. Users that join Confluence this way will get default product access.

If the user isn’t on an approved domain, they’ll have to request access. They won’t be able to use project pages or Confluence until they’re approved by a site admin.

If a page is restricted in Confluence, the same permission settings apply to project pages.

Learn more about specifying how users get access.

 

Last modified on Jun 29, 2021
Cached at 9:00 PM on Jul 31, 2021 |

Additional Help

Ask the Community