Integrate Release Notes and Roadmap from Released.so

Integrate release notes and roadmaps from the Jira app Released into your Scroll site.

Released is a Jira app that helps you create release notes and roadmaps straight out of your Jira issues using the assistance of an AI copywriter. These release notes and roadmaps can then be published as an announcement page or widget.

This guide will show you how you can embed your Released announcement page or widget into your Scroll site.

Released.so integration in the Help center theme

The announcement page is ideal if you would like the Released content to tightly integrate with the rest of your documentation. The widget is best if you would like to let your users easily find out what’s new from everywhere in your site.

Embed the Announcement Page from Released into Scroll Site

Released lets you publish all your release posts into a standalone announcement page. You can make this announcement page and its content appear on one of the pages in your Scroll site. For that we will use an empty page that acts as a placeholder.

This page will always reflect the latest updates that you publish with Released, without having to update your Scroll site. You can embed the announcement page following these steps:

Create a new Confluence page, right where you want the announcement page to appear in your Scroll site.
Enter a page title and leave the rest of the page empty.
Publish the Confluence page to Scroll Sites.
Navigate to the page in your Scroll site.
Inspect the HTML of the page using your browser’s dev tools. In the HTML, search for data-page-id and copy out the ID that appears next to it (example: ci_1de86001abebf744bdf532713da2ee00d138a77bfcb8e6d6265fcacff907d62b)
Navigate to the Released settings in your Jira project and locate the channel ID in the embed code of the Announcement Page settings.
Note down the channel ID from the embed code.

Copy the following Javascript code:

JS

if (document.documentElement.getAttribute('data-page-id') === 'PAGE_ID') {
  sts.loadScript('https://embed.released.so/1/embed.js').then(() => {     
    document.getElementById("content").innerHTML = '<released-page channel-id="CHANNEL_ID" color-scheme="light"></released-page>'
  });
}

Replace the placeholders PAGE_ID and CHANNEL_ID in the code above with the IDs noted in the previous steps.
Insert the complete code into Scroll Site’s Javascript editor.
Save and update your site.

When opening the specified page in your Scroll site, your announcement page will be rendered over it. Any changes you make in Released that affect the announcement page will automatically reflect on this page - no site update needed.

Embed the Widget from Released into Scroll Site

Embed the widget with the help of a simple widget code:

Navigate to the Released settings in your Jira project and locate the channel ID in the embed code of the Widget settings.
Note down the channel ID from the embed code.

Copy the following Javascript code:

JS

sts.loadScript('https://embed.released.so/1/embed.js').then(() => {
  document.body.insertAdjacentHTML('beforeend', '<released-widget channel-id="CHANNEL_ID"></released-widget>')
});

Replace the CHANNEL_ID placeholders in the code above with the ID noted in the previous step.
Insert the complete code into Scroll Site’s Javascript editor.
Save and update your site.

Your widget will now appear on all pages of your site and can be opened with the help of a small icon from the bottom right corner of your pages.

The announcement page is ideal if you would like the Released content to tightly integrate with the rest of your documentation. The widget is best if you would like to let your users easily find out what’s new from everywhere in your site.

Embed the Announcement Page from Released into Scroll site

Released lets you publish all your release posts into a standalone announcement page. You can make this announcement page and its content appear on one of your Scroll site pages. For that we will use an empty page that acts as a placeholder.

This page will always reflect the latest updates that you publish with Released, without having to update your Scroll site. You can embed the announcement page following these steps:

Create a new Confluence page, right where you want the announcement page to appear in your Scroll site.
Enter a page title and leave the rest of the page empty.
Navigate to the page in your Scroll site.
Inspect the HTML of the page using your browser’s dev tools. In the HTML, search for data-page-id and copy out the ID that appears next to it (example: ci_1de86001abebf744bdf532713da2ee00d138a77bfcb8e6d6265fcacff907d62b)
Navigate to the Released settings in your Jira project and locate the channel ID in the embed code of the Announcement Page settings.
Note down the channel ID from the embed code.

Copy the following Javascript code:

JS

if (document.documentElement.getAttribute('data-page-id') === 'PAGE_ID') {
  sts.loadScript('https://embed.released.so/1/embed.js').then(() => {
    document.getElementById("content").innerHTML = '<released-page channel-id="CHANNEL_ID" color-scheme="light" color-scheme="light" top-offset="80px" color-primary="#FFF"></released-page>'
  });
}

Replace the CHANNEL_ID and PAGE_ID placeholders in the code above with the IDs noted in the previous steps.
Insert the complete code into Scroll Site’s Javascript editor.
Save and update your site.

When opening the specified page in the Scroll site, your announcement page will be rendered over it. Any changes you make in Released that affect the announcement page will automatically reflect on this page - no site update needed.

Embed the Widget from Released into Scroll Site

Embed the widget with the help of a simple widget code:

Navigate to the Released settings in your Jira project and locate the channel ID in the embed code of the Widget settings.
Note down the channel ID from the embed code.

Copy the following Javascript code:

JS

sts.loadScript('https://embed.released.so/1/embed.js').then(() => {
  document.body.insertAdjacentHTML('beforeend', '<released-widget channel-id="CHANNEL_ID"></released-widget>')
});

Replace the CHANNEL_ID placeholders in the code above with the ID noted in the previous steps.
Insert the complete code into Scroll Site’s Javascript editor.
Save and update your site.

Your widget will now appear on all pages of your site and can be opened with the help of a small icon from the bottom right corner of your pages.