Join us for JSM June'24 on Atlassian Community and discover new ways to use Jira Service Management. Learn more

Quick start guide


This guide is for anyone getting started setting up a service project in Jira Service Management. If you haven’t done so already, sign up for Jira Service Management for free. Once you’re in Jira Service Management, you can get everything set up by following the prompts. If you need additional help, or just want to see everything in one place before diving in, this guide is for you.

Note that this guide is specifically for Jira Service Management project administrators. If you are a Jira Service Management agent, check out our Agent Onboarding Guide instead.

Step 1 - Set up and customize your project

Create your service project

Jira Service Management has a variety of project templates to help teams get set up quickly by creating projects tailored to a specific team or use. These templates include pre-configured request types, workflows, and other relevant features. There are templates available for IT and customer service management, as well as a range for templates for business teams like HR, finance, and marketing.

Jira Service Management Project templates screen

To create a service project:

  1. From the top menu bar select Projects, then Create project.
  2. From the Service management category, browse the available templates and select the one that best suits your needs.
  3. Review the template’s details, and if you’re happy with the one you’ve chosen, select Use template (or if you’ve chosen a Blank template, select Create blank project).
  4. Select either a team-managed or company-managed project type. (Note: team-managed project types are only available for certain project templates.)
  5. Name your project.
  6. Create a project key or use the generated key.
  7. Select the type of team that will use the project. This can be changed later in project settings.
  8. Select your the channel access to determine who can send requests to this project.
  9. If you would like to share settings from an existing project, specify the name of the project.

  10. Review your project type selection (If the project template is available in both project types.

  11. If you’ve selected a team-managed project type, review the Access and Default language settings.

  12. Select Create project.

Customize your help center and portal

Customers go to your help center and portal(s) to request help. Customization is important to ensure that you provide a consistent brand experience in which your customers see all the relevant information.

Jira Service Management help center

Customize your help center

Let’s start with the help center. Every Jira Service Management site comes with an online help center. And every service project comes with a portal. From the help center, customers can browse all the service project portals they have access to, submit requests, and search your embedded knowledge base to help themselves. Below is an overview of the key settings you can customize in the help center:

Login message

Add a message on your login page to welcome your customers or guide them through the login process.


Announcements on your help center’s home page keep your customers updated on important news or service-related issues.

Look and feel

Customize the look and feel of your help center, including:

  • Help center name
  • Home page title
  • Logo
  • Banner
  • Banner background, link, and button color
  • Help center banner text color

Home page layout

Customize how your portals are displayed in your help center. Organize and feature your portals to make sure that your customers can find what they’re looking for. You can also sort your remaining portals by popularity or name.

To change any of the items above:

  1. Go to Settings > Products.
  2. Select Configuration under Jira Service Management in the sidebar menu.
  3. Under Customize your help center, you’ll see a list of customization options available to you.
  4. Choose the relevant option, make changes, and select Save changes.
Customization option available in Jira Service Management's help center

Customize your service project's portal(s)

Every service project comes with an online portal that your customers use to interact with your service team. These portals live within the help center so that your customers can request help from any team within your organization in one centralized location. Similar to the help center, you change the name of your portal(s), welcome customers with an introduction, and add your company’s logo to reflect its brand.

To customize your portal(s):

  1. From your service project sidebar menu, go to Project settings > Portal settings.
  2. Edit the Name, Introduction text, and Logo fields as needed. Your logo will appear in notifications sent by your service project.

Your portal’s header, URL, and button colors are inherited from the help center.

Configure your service project’s email address

Your service project comes with a pre-configured cloud email address that you can send to customers to start using right away. You can also add one custom email address to link to an existing account (for example, the email address your IT team uses for incoming requests).

To add a custom email account for incoming requests:

  1. From your service project sidebar menu, select Project settings > Email requests.
  2. Choose your email service provider in the connect a custom email account section and follow the prompts to link your account.

Step 2 - Set up your request types and customize your queues

Set up your request types

Request types help you define and categorize incoming requests and allow you to collect the information you need to resolve them. Your service project comes with default request types based on the project template that was used to create it. You can customize these and add more to suit the needs of your customers and team.

Request types can be organized into portal groups to make it easy for customers to seek the help they need. Below you can see an example of an HR service portal with request types for new employee orientation, onboarding, offboarding, internal transfers, training, and much more.

Jira Service Management example service portal

To create a new request type:

  1. From the navigation on the left, select Project settings, then Request types
  2. Select Create request type.

From here, you can select Create custom to build your own request type, or select Create from template to use templates designed for different teams and use cases to quickly create a new request type that you can edit later.

Create custom

  1. Select Create custom.

  2. Enter the request type name, description, icon, and issue type, then select Next.
  3. Select a portal group, create a new portal group, or leave the checkbox unselected to hide this request type from your portal, then select Create.

Create from template

  1. Browse, search, and Preview the different templates.
  2. Select the template you want to use to create your new request type.
  3. Review and update the request type’s details including name, description, icon, portal group, and issue type and associated workflow, then select Save.

For both these methods, the request type object will be created and associated with the selected issue type and workflow.

You’ll then need to determine what fields will be displayed to both your customers and your agents. You can customize each request type to show different fields and collect the exact information your team needs to succeed.

To edit a request type, including fields available in the agent and customer views:

  1. From the navigation on the left, select Project settings, then Request types
  2. Select the request type you want to edit.
  3. In the Request form tab you can manage the fields that your help seekers will see and fill in when they raise a request in the portal.
    1. Drag and drop from the panel on the right to add new fields, search for fields already used on your site, or create a new custom field. You can add instructions for fields, mark them as required, or assign preset values.
    2. Search and attach existing forms to the request type by selecting Add form, selecting the form you want to use from the dropdown list, then selecting Add. If no forms exist, navigate to Project settings and then Forms to create the forms you need.
  4. In the Issue view tab you can manage the fields that your agents will see – the fields that are visible to them only, as well as the fields help seekers will see on the request form. Drag and drop from the panel on the right to add new fields, search for fields already used on your site, or create a new custom field. Reorder the fields, or drag fields to Hidden when empty to change to agent’s view of the issue.

Note: In company-managed projects, each request type is associated with an issue type. These issue types can be shared across projects in your Jira site. Available request type fields and workflows are based on their associated issue type’s fields and workflows.

In team-managed projects, each project has its own request types that can’t be shared across projects. This means that each team-managed project has its own request types that are independent of other projects and are not associated with an issue type.

To edit or change a workflow for a request type:

  1. From the navigation on the left, select Project settings, then Request types. Select the More menu next to the request type you want to update.
  2. To edit a workflow, select View and edit workflow. Select Edit workflow, make your changes then select Publish.
  3. To replace a workflow, in the Workflow section:
    1. select Replace using template, which will enable you to create a new pre-configured workflow from a template and link it to your request type. Preview a template to see its description, statuses, and transitions. Select the template you want to use, then review and make desired changes to the names of your new workflow and issue type. Select Continue and the new workflow and issue type will be added to your project and linked to the request type you chose to update.
    2. or select Replace with existing. Choose the workflow you want to use then select Update.
  4. These options for editing or replacing a workflow can also be accessed from a specific request type's configuration screen. Select Manage workflow, then select the option you require.

Customize your queues

When your service project customers raise a request, that request becomes an issue in a queue. Queues help you automatically triage issues, organize the way issues appear to your team, and highlight the issues your team should work on first based on your SLAs. Your team will be able to see how many issues are in each queue and switch between queues to work on the right issue at the right time.

Jira Service Management comes with default queues that project admins can update to align with the way your teams triage and work on customer requests.

To access your queues:

  1. From your service project sidebar menu, go to Queues.
  2. Switch between queues in the sidebar menu by selecting them.

Organize your queues:

Queues can also be organized into three sections to keep your workspace tidy:

  • Starred - Starring a queue helps you handpick your favorite queues and access them quickly from your service project. Starred queues appear only in your view and won’t impact your team’s work.
  • Team priority - Business-critical queues for agents to see at all times.
  • Other - Queues are collapsed in this group but agents can Star to pin them in place.
Example of a customized queue in Jira Service Management

To arrange queues:

  1. From your service project sidebar menu, go to Queues.
  2. Select Manage queues.
  3. Drag and drop the queues between the two groups: Team priority and Other.
  4. Select Close.
Manage queues screen from Jira Service Management

To star a queue, simply hover over the queue of your choice and select the star icon

Create a new queue

As we mentioned earlier, Jira Service Management comes with a set of out-of-the-box queues that your team can use and you are able to edit the default queues to display issues based on your preferences.

Jira Service Management also allows you to create your own queues to suit your needs. These can be set to show specific requests based on their type, status, or something more specific using a Jira query language statement.

To create a new queue:

  1. From your service project sidebar menu, go to Queues.
  2. Select Manage queues from the navigation sidebar.
  3. Select Create new queue.
  4. Enter a name for your queue.
  5. In the Filter by section, select the issue type, status, resolution, and label from the drop-down menus. You can also select Advanced to enter a JQL statement.
  6. If required, select criteria from the More drop-down menu.
  7. If required, select an order from the Order by drop-down menu.
  8. From the Columns section, update columns by dragging and dropping to the required location. This is the order of the columns that appear in your queue.
  9. Select Create.
Create a new queue in Jira Service Management

Step 3 - Add your team members and customers to your service project

Add team members to your project

It’s time to get the party started! Once you have your new project set up, start inviting team members. To get your team involved, start by adding each team member as an agent to your service project.

To add team members:

  1. From your service project sidebar menu, go to Invite team.
  2. Enter the email(s) of the users you would like to add as an agent.
  3. Select Invite.
  4. Your agent is added to the Service Project Team role and receives an email with a link to the service project.
Invite team members to your project in Jira Service Management

Add customers to your project

Next, let’s add customers to your newly created service desk. Customers are people who request help from your service project. You don’t need to add customers to your service project right away, but it’s important to learn how to add them.

Both administrators and service project agents can add customers to a service project.

To add customers:

  1. From your service project sidebar menu, go to Customers.
  2. Select Add customers.
  3. Enter the customer’s email. Separate customers by commas to add more than one at a time.
  4. Add the customer to an organization (optional).
  5. Select Add.
  6. Customers will receive an invitation email. Go to customer notifications to view or customize the invitation email.

You can also set up Jira Service Management to allow customers to add themselves. Or, you can open your service project to Jira users. Learn more about customer permissions.

Add customers in Jira Service Management

Now that you’re done with the basics, take your project to the next level with our collection of helpful how-to guides, explainers, and documentation. There’s plenty more to learn…

  1. Check out our Jira Service Management on-demand demo where you can choose specific features that you are interested in for a personalized demo.
  2. Check out the other Jira Service Management product guides, covering everything from basics to in-depth practices.
  3. Download Jira Service Management for Mobile so you can deliver great service on the go.

About Jira Service Management


Getting Started

Service Request Management