Creating, editing, deleting, and hiding projects

As a Jira administrator, you can create projects for all Jira applications that have been added to your site. Note that you can only view and delete a Jira application project if you have access to that application, so as an example, you'll need Jira Service Desk application access to work in a service desk project.

To create projects, you must have either the Administer Jira or Create independent projects global permissions. Learn more about global permissions.

How to create a project

  1. Choose the Jira icon (, or ) > Projects.
  2. Click Create project. You can create a new project in a few ways:

    • Select one of the available project types (e.g. scrum software development). Note that project types will appear based on the Jira applications you have subscribed to. 
    • Create a project with a shared configuration to use the permission, workflow, issue type and other schemes from an existing project.
    • Create a project with sample data to explore the features that come with each project type.
    • You can also import a project from one of the Jira importers. See Migrating from other issue trackers for more info.
  3. Once you select a project type or an existing project for shared configuration, click Next. For new projects without sample data, you'll see the default workflow used by that project type.

  4. Enter a project name, project key, and project lead, and click Submit.

    Note

    If you're creating a project using a project type related to an application you currently do not have access to, Jira will display a checkbox that will allow you to grant yourself access to that application. This will add you to the default group of that application, and you will count as a user for that license.

How to edit a project

  1. Choose the Jira icon (, or ) > Projects.
  2. Go to the project you want to update and click Edit
  3. Change the project details and click Save details.

How to change the project type

At some point, you may wish to convert an existing project to a different project type. You can, for example, convert a Jira Software project to a Jira Core project at the end of a Jira Software evaluation period. You can only convert to project types for existing Jira applications.

  1. Choose the Jira icon (, or ) > Projects.
  2. Go to the project you want to update and click Edit
  3. Select a new project type and click Save details.

How to delete a project

Once a project has been deleted, it can only be recovered by reinstating a backup or an XML copy. This isn't the most fun thing to do, so make sure you're prepared to delete the project's issues, versions, and components. Associated schemes, workflows, issues types, or any content that could be shared with another project won't be affected.

  1. Choose the Jira icon (, or ) > Projects.
  2. Find the relevant project and click Delete.

How to hide (or archive) a project

A 'hidden' project will still be visible to people with admin permissions; regular users won't be able to search, view or modify any of the project's issues.

  1. Create a new permission scheme, and leave all of the permissions empty:
    1. Select the Jira icon (, or ) > Settings > Issues.
    2. Click Permission Schemes > Add Permission Scheme.
  2. Associate the new permission scheme with the project that you wish to hide (see the section Associating a Permission Scheme with a Project ):
    1. Choose the Jira icon (, or ) > Projects. Select the relevant project.
    2. Open the Project Summary administration page for that project. (See Configuring projects.)
    3. In the Permissions section, click the name of the current scheme.
    4. Click the Actions dropdown menu and choose Use a different scheme.
    5. On the 'Associate Permission Scheme to Project' page, which lists all available permission schemes, select the permission scheme you want to associate with the project.
    6. Click the Associate button to associate the project with the permission scheme.

As an admin, you will still be able to see hidden projects. People without admin permissions will not be able to see hidden projects.

Last modified on May 30, 2018

Was this helpful?

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