Versions Compared

Key

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

Due to maintenance, it’s temporarily not possible for customers whose accounts were created after 20 August 2023to add Jira Software projects to Refined sites.

If you have any questions, please contact us.

...

Refined Sites for Jira Service Management (JSM) Cloud combines key features from Server/DC with the convenience of the cloud. However, there are also some notable differences between the two products.

On Server/DC, Refined Sites is added on top of Jira. When enabled globally, it acts as a skin applied to the JSM help center.

...

Migrating to a new platform can be a great opportunity to rethink your JSM and Refined Sites setup. We recommend to evaluate what was working well on the Server/DC instance - and what you can improve. You can opt to replicate your Server/DC setup on Cloud with improvements here and there, or see Cloud as a blank canvas to create a totally new setup.

...

There are multiple ways of doing this. You might face some limitations, based on which option you choose. We recommend adding Confluence spaces to your site using Refined Sites for Confluence Cloud. This lets you take full advantage of Refined Sites’s Sites’ user-friendly browse and search experience, which includes:

  • The ability to embed request types directly on Confluence pages.

  • Page tree menus in the left-hand menu of the Confluence spaces.

  • Confluence modules on your landing pages:

...

Because Refined Sites for Cloud works as a site builder parallel to native JSM, the app doesn’t change native JSM. Therefore, Refined Sites doesn’t impact third party apps that provide functionalities in native JiraJSM, but might impact apps that provide functionalities in the customer-facing portal.

...

App

Description

Refined Sites for Jira Service Management Cloud

Required

Required app.

Refined Sites for Confluence Cloud
Optional

Install if you want to integrate Confluence spaces in your Cloud sites, for example to create a help center.

Step 3. Upgrade Refined

...

for Jira Service Management Server/DC

Upgrade Refined Sites for JSM Server/DC to the latest available version. How to upgrade depends on which version you currently use. To check your current version, go to the Confluence AdministrationManage apps.

Your current version

How to upgrade

Version 1.0.0 - 2.1.10

  1. Install version 2.1.10 from Atlassian Marketplace.

  2. Navigate to Refined Sites Configuration and ensure it’s working.

  3. Install version 3.0.0 of Refined Sites for JSM

  4. Follow the instructions for the 3.0.0 upgrade: https://refined.atlassian.net/wiki/spaces/JIRADC/pages/4704249566/Version+3.x+release+notes#Version-3.0-Upgrade-instructions

Version 3.0.0 - 3.2.x

  1. Go to the Confluence AdministrationManage apps.

  2. Install version 3.3.0 of Refined Sites for JSM

  3. Follow the instructions for the 3.3.0 upgrade: https://refined.atlassian.net/wiki/spaces/JIRADC/pages/4704249566/Version+3.x+release+notes#Version-3.3-Upgrading-instructions

  4. Proceed with the steps below

Version 3.3.0 or newer

  1. Go to the Confluence AdministrationManage apps.

  2. Install the latest version of Refined Sites for Confluence.

Step 4. Export a site with the migration assistant

...

Layout Editor modules
Server/DC

Page Builder modules
Cloud

HTML

HTML

Issue Types

Issue Types

Jira Issues

Jira Issues

Knowledge Base

Replace the module with a Text module in the layout that you download, or exclude it altogether. In the Text module, you can manually add links to your Confluence Cloud knowledge base.

My Requests

My Requests

Navigation Cards

Card

Navigation Image

Image

Navigation Icon

Icon

Navigation Content

This module is automatically replaced with an Image module with the Navigation Content style.

Navigation Highlight

This module is automatically replaced with an Image module with the Navigation Highlight style.

Request Types

Request Types

Rich Text

Text

Search Highlight

Search Highlight

Site Navigation

Site Navigation

Popular Service Projects

Replace the module with a Text module in the layout that you download, or exclude it altogether. In the Text module, you can manually add links to projects that you know are most popular.

Recent Request Types

There is no alternative for this module on Cloud, so it won’t be included in the downloaded layout. If you plan to add another module in its place on Cloud, a placeholder can help you see where the module used to be.

Once you’ve migrated the layouts, you can also start using these modules:

...