Creating, editing and deleting independent projects

Still need help?

The Atlassian Community is here for you.

Ask the community

Currently, you can only create independent projects using the agility project template.

Create an independent project

To create a project:

  1. Choose the Jira icon (, or ) > Projects.
  2. Select Create project.
  3. Give your project a name.
  4. Choose who can access your project.
  5. Select Create.

We automatically generate a project key when the project is created.

Edit an independent project's details

In independent projects, you can edit the project's:

  • Name
  • Key
  • Icon
  • Access

To change these details: From your project's sidebar, select Project settings > Details.

Change your project's key

Project keys provide a shorthand for the issues in your project. Together with an issue's key, this abbreviation is the foundation of how work is tracked and referred to in Jira.

To change your project's key:

  1. From your project's sidebar, select Project settings > Details.
  2. In the Key field, enter your desired key. Your project's key must:
    • be at least two characters long
    • start with an uppercase letter
    • and, contain only uppercase letters or numbers
  3. Select Save details.

After you change a key, we recommend communicating the change to your team. For example, board filters and dashboard filter gadgets need to be updated with the new key.

Change your project's icon

Project icons help give a face to your project's name. They appear in the project sidebar and in your site's list of all projects.

To change your project's icon:

  1. From your project's sidebar, select Project settings > Details.
  2. Under the current icon, select Change icon.
  3. Choose from a default icon or upload your own.
  4. Select Save details.

Change who can access your independent project

Independent projects can be personal and private. Or, they can be open for anyone on your Jira site to see. We recommend keeping your work open and accessible. Break down those silos!

But, if you want to restrict who can view or comment on issues in your project, you can change you project's access.

To change your project's access:

  1. From your project's sidebar, select Project settings > Details.
  2. In the Project access drop down, select the level of access you want.
  3. Select Save details.

Access levels change who can search, view and edit the project and its issues. If you set your project to Private, the project is hidden from everyone on your Jira site. Only people added to the project can see it in their project directory, or its issues in search results. Other people on your site will never know the project exists. Jira admins can see private projects in the project directory, but they don't have access to view or interact with a private project's issues.

Delete an independent project

If you delete a project, only a Jira admin can recover it from a backup or an XML copy (if one exists!). This isn't the most fun thing to do, so make sure you truly want to delete the data associated with your project.

To delete an independent project:

  1. From your project's sidebar, select Project settings > Details.
  2. Select ••• > Delete project.
Last modified on Jun 7, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.