What is a project?

This feature is currently in beta as part of the Platform Experiences early access program (EAP).

Read more about the EAP and how you can join

An Atlassian project represents any piece of work that people on your team or stakeholders at your company would like to receive regular weekly updates about to stay in the loop. Projects help bring work into one place and provide just the right amount of context so that anyone at your company can understand what is being worked on, why it is happening, who is responsible for it, and how it is going.

A project feed in Atlassian.

How is this project different from a software project in Jira?

A Jira software project is simply a collection of issues (stories, bugs, tasks, etc). You would typically use a project to represent the development work for a product, project, or service in Jira.

Meanwhile, Atlassian projects are more focused on concrete work or workstreams that have a set definition of done, and are better suited for anything you’d want to provide regular updates on. They’re more similar in size and scope to a Jira epic, as both are striving to achieve a specific outcome or complete a body of work. Because of this similarity, Jira epics can be linked to both Atlassian goals and projects to keep the progress updates in sync with the work itself.

When a project in Atlassian Home is linked to an issue in Jira, it’s referred to as a “Project overview” on the issue view to avoid confusion with a software project. The “Project overview” in the Jira issue is exactly the same as the equivalent, linked “Project” in Atlassian Home.


  • A Software Engineer uses Jirato track the launch of a new feature

  • They encounter a bug, which means they have to delay the release date by two weeks

  • The Engineer shares a short update from Atlas on the delay - without needing to go into a lot of detail

  • A Marketing Manager sees the update and quickly gets context - without having to message the Engineer or search through their software project

  • The Marketing Manager adjusts their campaign plans accordingly and shares an update

  • The VP of Marketing and Sales sees these updates and understands within minutes why there has been a blocker

How projects work

At Atlassian, we create a project when a piece of work involves 2+ people for 2+ weeks. That way, we can consolidate and deliver updates on that work to anyone in the organization who wants to know how it’s progressing. You can set your bar higher or lower. The most important thing is to set a threshold low enough that your team will always have visibility into any piece of work that could block, impact, or have a dependency on the work of other teams.

Projects are updated each week. Project owners are sent a reminder to write their update on Friday morning, and updates are shared with followers on Monday in both their email digest and the update feed on Atlassian Home.

Creating a project

To create a project: click the blue Create button in the top nav.

  1. Go to Atlassian Home.

  2. Select the blue Create button at the top of the screen.

  3. Enter a descriptive name for your project. You can use any sort of descriptive modifiers that identify the team or department, such as [RD] or [MKT].

  4. Pick an emoji and color to represent your project to serve as a simple, visual indictor to help differentiate projects.

  5. Decide if you want anyone in your organization to be able to view this project or make it private (viewable only by people you or the project owner invites)

Once the project is created, you’ll be taken to the project page where you can add more details, include important links, and other details that may be relevant to your project.

Writing the About section

The about section of a project in Atlassian.

The About section of a project answers 3 key questions to help teammates and stakeholders quickly get context

To help teammates and stakeholders quickly get context on your project, the About section is where you can provide the answers to 3 key questions:

  • What are we doing?

  • Why are we doing it?

  • What will success look like?

At Atlassian, we shoot for 3-5 sentence descriptions for each question. Try to be succinct and give the short version of each answer. You can always include links to other pages, dashboards, epics, and more for folks who want to dive deeper into the details.

Adding an owner, contributors, and followers

By default, the person who creates the project is set as the owner and is also added as a follower. Project owners are responsible for adding relevant details to the project page, inviting contributors and followers, and writing the status update each week, ensuring that any progress, blockers, or change of plans are communicated. Owners can adjust their notification prfere

For anyone working directly with you on this work, you can add them as a contributor which will also add them as a follower. You can add individuals, entire teams, or just select individuals from a team. Contributors can edit project details and write status updates, just like the owner—the main difference is that contributors are not the person primarily responsible for doing so. When whole teams or individuals from a team are added, the project will appear on the team profile.

When determining who should be a follower, your manger, peers in your organization, and key cross-functional partners are great candidates to start with. These are usually the people who would want to know how things are going, and can now get your updates automatically.


Additional Help