Best practices for designing the customer portal

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Every service desk project comes with a preconfigured customer portal that your customers use to interact with your service team. Here are some best practices on how to design an easy-to-use customer portal that will help both your team and your customers work more efficiently. 

On this page:

Brand your help center

Customers can use the global help center to search for request types and knowledge base articles across all customer portals they have access to. Brand your help center by:

  • Uploading your company logo and your service desk can automatically generate a matching theme for your customer portals and global Help Center header. 
  • Naming your customer portals and global Help Center, so your customers can easily identify your team's service desk.

 

Brand your customer portals

For each project's customer portal, you can customize the name, welcome message, and logo to let customers know which portal to use to contact a specific team in your organization. Note that the help center name and header appear across all your project's customer portals. 

Check out Configuring the customer portal to learn more.

Help customers find the request types they need

  • Name request types in language that's familiar to your customers, and use keywords they'll recognize. For example, name a request 'Access to a system' instead of 'VPN access'. 
  • Use different icons for different request types, so customers can easily identify request types in the customer portal.
  • Add contextual help (e.g. specify photo dimensions and format for the attachment field) with the Field help field.
  • Use examples in your request type descriptions (e.g. 'If you need a software license such as Microsoft Office, raise a request here'). 
  • Link to existing information that might be helpful for customers in the request type description. For example, if you have already have a list of available Microsoft Office license numbers on your Intranet, simply add a link to the page in the request type description and instruct customers to claim a license from that page without needing to open a request. 

See Setting up request types for more information on naming request types.

Group related request types

  • If you have a large number of request types, e.g. more than 7, customers will probably need to scroll to get to some of them. In this case, consider grouping some request types together. To set up groups, use the Groups drop-down and type the group name:
  • You can also control the order in which request type groups appear on the customer portal by adding a number to the group name. Groups appear as tabs on the left-hand side of your customer portal: 

See Setting up request types for more information on managing request types and groups.

Set up a knowledge base

  • After using your service desk for a while, your team will probably have accumulated a large amount of information that can be provided to your customers so that they can solve some problems before even opening requests. At this point, you can consider integrating Confluence's knowledge base capabilities with Jira Service Desk. 
  • Connect your service desk project to a Confluence space so customers can search for relevant knowledge base articles on the customer portal:  

For information about how to achieve this, see Serving customers with a knowledge base

Last modified on Jan 17, 2016

Was this helpful?

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