Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

With Refined you can add several sites to one Jira instance. Sites are separate landing pages creating separate areas of your Jira. 

When you install or upgrade to Refined 2.0, all your JIRA Service Management (JSM) projects will be contained in the Help Center site. This site is the default one and you can't remove it or disable it. You can add more sites for different purposes.

Sites are added and managed in the Site Builder within the Refined Administration. This is also where you add, remove and organise Refined sites and categories. 

Jira Service Management portals

When Jira Service Management is installed in your Jira, there will be a global JSM site and all JSM projects will be added to this one. 

Jira projects

Jira projects are manually added to a Refined Site.

...

By adding Refined sites in your Jira instance, you create separate experiences for each of your users. For example, you can create one IT help desk that includes your Jira projects related to IT, and one HR help desk that includes your HR-related Jira projects.

You can add structure to your sites by organising your Jira projects into categories and subcategories. Since Refined version 3.0, you can also add custom links to your site’s navigation.

Site Builder

The Site Builder is the essence of your Refined site. It’s where you add content and build the navigation menu. There are two ways to access the Suite Builder:

Expand
titleVia Jira Administration
  1. Go to Jira Administration > Manage apps.

  2. Click Refined Configuration > Open Refined Administration.

...

Expand
titleVia a Refined site or portal
  1. From the Refined site, click the Cogwheel in the top right corner. 

  2. Click Site Builder. 

Global JSM site and additional Refined sites

When you combine Refined (version 2.0 and newer) with Jira Service Management, your Help Center from native JSM is replaced by a Global JSM site. This site can’t be removed and holds all your Jira projects: from JSM, but also from Jira Core and/or Jira Software, if you have them installed.

Aside form the Global JSM site, you can add as many additional sites as you want by clicking the Add site button in the Site Builder. You can then drag and drop projects away from the Global JSM site into the additional sites. If you have installed Jira Core and/or Jira Software as well, it is possible to also add projects from there into your Global JSM site by clicking the + Plus icon > Include Jira Projects.

When you combine Refined with only Jira Core and/or Jira Software, there is no global site. You have to manually create one or more Refined sites, and add projects to them.

Using Refined only on specific sites

By default, Refined applies to your Global JSM site. If you prefer to keep the default JSM look and feel, go to the Jira Service Management tab and turn off Activate Refined globally:

  • Turned off means that Refined applies to all your JSM portals: the ones on your Global JSM site as well as the ones on all additional sites. In the Site Builder, a green label on the Global JSM site

...

Go to the Site Builder.

...

  • tells you that theming is activated.

  • Turned on means that Refined only applies to JSM portals that are placed on other Refined sites. In the Site Builder, a blue label on the Global JSM site tells you that theming is not activated.

Note that Refined always applies to additional sites.

Site settings

You can set up the site when adding it in the site builder, and edit it later by xyz

  1. Add the name and the URL path to the site, the URL can be used as a link to the site.

  2. Set the permissions for the site. Note: The permissions determine what users can see the site. If a JSM project is placed on a site, having a URL for a portal the user can see, will show the portal even though the user can't see the site itself. Permissions are based on User Groups, set up User Groups and add your users to these accordingly.

  3. Site logo. The site logo will be shown for this site.

  4. Set the Theme for the site. Leave it empty to use the same theme as on the Help Center site.

  5. If you want the Site Switcher to be shown on this site, make sure this option is checked.

  6. Start site for groups. The start site feature makes it possible to direct users to specific sites when they log in. This setting is based on Jira User Groups and can be used for licensed and unlicensed (JSD customer) users. 

  7. Start site for anonymous users. Check this box to make this site the start site for any user that is not logged in. 

Drag and drop the JSM projects you want to have on this site.

Add categories. A category allows you to further direct your users and divide your portals, or get you a landing page where you can add information and links.

...

Using Refined sites with projects from JSM

When you have installed Refined and Jira Service Management, there is always a Global JSM Site. This site is the equivalent to the Help Center of default JSM, which holds all JSM projects. It can have the default JSM look and feel, or you can add a theme to it with Refined.

Globally activated Refined JSM site

Having the Global JSM site themed means that Refined will be applied to every JSM portal. In this example the two JSD portals will be in a Refined Site. Any Jira Service Management project that exist on the site will show up in the Global JSM Site

...

A default Global JSM Site

...

In this example, the two JSM portals will be in the default JSM theme and site. 

Having Refined not activated globally means that JSM portals in the global site will not be themed, while JSM portals in the other Refined Sites or categories will be themed. 

Using Refined sites with projects from Jira Core and Jira Software

When Jira Core and Jira Software are used either independently or together but without Jira Service Desk, there are no Refined Sites when Refined is installed. Any Refined Site has to be manually created. 

...

Any Jira Core or Jira Software project that you want to add to a Refined site needs to be manually added to the site - this means that you hand-pick which projects go on a Refined site. 

...

Using Refined sites with projects from Jira Core, Jira Software and JSM

You can add projects of any kind to any site, this is completely up to you. As soon as you have Jira Service Management the Global JSM site will be there, and you can add any project type to that site. 

...

In this example, there are three categories to further add structure to the Refined site, and there are two JSM portals and two Jira Software projects in the same Refined Site - in this example the Global JSM Site. 

Additional sites

Any additional site added to the Site Builder will always have the Refined theme activated. 

Creating structure on a Refined site

Every Refined Site has its individual structure and navigation made by adding categories and Jira items to the site. Categories are containers that are added to a site, and can be added in several levels to create subcategories. 

With version 3.0 you can add custom links, any URL to any place on the internet in your structure. Simply use "Add a link" to add a link to a site or a category.

...