Configure a project

To configure a project:

1. Choose Settings (), then Projects.

2. Choose the project you want to configure.

3. Go to your project.

4. Next to your project's name in the sidebar, select More actions (•••), then Project settings.

5. Use the links on the sidebar to navigate between the different project settings. Read the sections below for a description of each setting.

Project details

Select Details in the Project settings sidebar, and edit the project details as desired. Once you've completed your edits, don't forget to select the Save button. Note the following:

• Editing the project key: This is not a simple task. Read this page before you edit the project key: Editing a project key.

• Using the Wiki Style Renderer in the project description: You can use the Wiki Style Renderer to display rich text (HTML) in your project description.

• Choosing a project avatar: If you don't want to use a project avatar, you can upload a transparent pixel. This effectively loads the transparent pixel, which means you won't see an image.

Work types

Jira enables you to keep track of different types of things — bugs, tasks, helpdesk tickets, etc — by using different work types. You can also configure each work type to act differently, e.g. to follow a different process flow or track different pieces of information.

Select either Work Types in the left menu or one of the work types under it, e.g. Bug, Task, Story, etc:

• Work Types: Click this to configure which work types apply to this project (choose a work type scheme or edit the existing scheme). You can also configure the workflow, fields and screens for the work type in the project, but it is easier to do this by selecting one of the work types.

• One of the work types (e.g. Bug, Task, Story): Click this to configure the workflow/screen for the work type in the project. The workflow screen (Workflow tab) shows the workflow designer. The screen (View tab) shows the screen designer.

Work type layout

As a Jira project admin, you can edit the layout of work types in a project. You can decide which fields are shown in the work item view and on the position of those fields. You can access work item layout options from project settings, or open a work item and choose Configure at the bottom-right of the work item. See Configure field layout in the work item view for more information. 

Workflows

Your Jira work items can follow a process that mirrors your team's practices. A workflow defines the sequence of steps (or statuses) that a work item will follow, e.g. Open, In Progress, Resolved. You can configure how work items will transition between statuses, e.g. who can transition them, under what conditions, and which screen will be displayed for each transition.

• Workflow Scheme — the project's workflow scheme determines which workflows (work items state transitions) apply to work types in this project.

Screens

Jira allows you to display particular pieces of work item information at particular times, by defining screens. A screen is simply a collection of fields. You can choose which screen to display when a work item is being created, viewed, edited, or transitioned through a particular step in a workflow.

• Screen Scheme — the project's screen scheme determines which screens are displayed for different work item operations (view, edit, create);
  OR

• Work Type Screen Scheme — the project's work type screen scheme determines which screens are displayed for different work item operations (view, edit, create), for different work types.

Fields

Jira enables you to define field behavior: each field can be required/optional, rich text/plain text, hidden/visible. You define this behavior by using a field configuration.

• Field Configuration Scheme — the project's field configuration scheme determines which field configuration applies to work types in this project. (A field configuration determines each field's overall visibility, requirements, formatting (wiki/rich-text or plain) and help-text).

Settings

• Application Links (Configure project links) — if you have linked your Jira instance to other Atlassian applications, like Confluence, Fisheye or other Jira product instances, you’ll be able to link this Jira project to areas of those applications that contain information relating to your project or team. For example, Confluence spaces, Fisheye repositories, Jira projects (in another Jira product instance), etc. This allows you to take advantage of integration points between these applications. See Using AppLinks to link to other applications for information about application links and project links.

Roles

Different people may play different roles in different projects — the same person may be a leader of one project but an observer of another project. Jira enables you to allocate particular people to specific roles in your project.

• Project Lead — user fulfilling the role of project leader. Used as the 'Default Assignee' (except for Jira where it is set to 'Unassigned'), and potentially elsewhere in Jira (e.g. in permission schemes, notification schemes, work item security schemes and workflows).

• Default Assignee — the user to whom work items in this project are initially assigned when created. Can be either the 'Project Lead' (above), or, if Allow unassigned work items is set to 'On' in Jira's general configuration, 'Unassigned'. There are also default component assignees.

• Project Roles — members are users/groups who fulfill particular functions for this project. Project roles are used in permission schemes, notification schemes, work item security schemes and workflows.

Versions

Work items can be grouped in Jira by allocating them to versions. For example, if you are using Jira to manage the development of a product or manage the build of a house, you may want to define different versions to help you track which work items relate to different phases of your product or build (e.g. 1.0, 1.1, 1.2, 2.0, 2.0.1). Jira can help you manage, release and archive your versions. Versions can also have a Release Date, and will automatically be highlighted as "overdue" if the version is unreleased when this date passes.

• Versions — versions defined in the project. See the version management page for details.

Components

Components are subsections of a project. They are used to group work items within a project into smaller parts. You may want to define various components to categorize and manage different work items. For a software development project, for example, you might define components called "Database", "Usability", "Documentation". Work items can belong to multiple components. You can choose a default assignee for each component, which is useful if you have different people leading different sub-teams in your project.

• Components — sub-sections of a project used to group work items into smaller parts. Read more about components.

Permissions

Jira allows you to control who can access your project, and exactly what they can do (e.g. "Work on work items", "Comment on work items", "Assign work"), by using project permissions. You can also control access to individual work items by using security levels. You can choose to grant access to specific users, or groups, or roles (note that roles are often the easiest to manage).

• Permission Scheme — the project's permission scheme determines who has permission to view or change work items in this project.

• Work item Security Scheme — the project's work item security scheme determines what visibility levels work items in this project can have.

Notifications

Jira can notify the appropriate people when a particular event occurs in your project (e.g. "Work item Created", "Work item Resolved").

Notification settings enables the selection of specific people, or groups, or roles to receive email notifications when different events occur. (Note that roles are often the easiest to manage.)

• Notification Scheme — the project's notification scheme determines who receives email notifications of changes to work items in this project.

• Email — specifies the 'From' address for emails sent from this project.

The Default Notification Scheme (shipped with Jira) is associated with all new projects by default.

Project administrators can use the Project email audit to monitor email suppression and unblock work item notification emails after bounces or other errors.

Search by email address or user name to check any undelivered project work item notifications from the past 21 days. Use the filter to display emails based on their delivery status.

Go to your specific Project settings, then Notifications, then select Project email audit.

After unblocking requests are complete, users should start to receive work item notification emails within an hour. If a user is included in multiple projects, an Email unblocked update will show across all those project work item email audits so relevant project administrators have visibility.

Development tools

The Development tools section is only available on Jira, and can only be viewed by Jirausers. It gives you an overview of the development tools that are connected and which users can use the integration features between them:

• View permission - This section lists which users can see the development tools integration features (like the Create Branch link) on the view work item screen, as well as other development-related information, like commits, reviews and build information. This ability is controlled by the "View Development Tools" project permission.

• Applications - This section shows which development tools are connected to Jira via application links and are eligible to use the development tool features in Jira.