Confluence Embed Macro

This guide will walk you through installing and configuring Released Portals for Confluence.

Installation

1

Navigate to the Atlassian Marketplace

https://marketplace.atlassian.com/apps/3830961120

2

Install the App

• Click Install or Try it free

• Review the permissions requested by the app

• Click Accept & install

3

Verify Installation

• The app is now available in all Confluence pages

• You can start using the Released Embed macro immediately

---

Using the Macro

1

Edit a Confluence Page

• Navigate to the page where you want to embed your Released portal

• Click Edit in the top right

2

Insert the Released Embed Macro

• Type / to open the quick insert menu

• Type "Released" and select Released Embed from the list

• Or use the toolbar: Click + → Search for "Released Embed"

3

Configure the Macro

• A configuration dialog will appear

• Enter your Channel ID (required)

• Optionally configure additional settings

Setting	Description	Required
Channel ID	Your Released channel identifier. Learn more	✅ Yes
Module	Choose what to display: Changelog, Roadmap, or All	No (default: All)
Show Header	Toggle header visibility	No (default: Off)
Primary Color	Custom hex color code (e.g., #6514DD)	No

4

Review the Preview

• The macro will show a preview in the editor

• If you don't have a valid Channel ID, you'll see an empty state message

5

Save and Publish

• Click Publish in the top right

• Your Released portal is now live on the Confluence page

---

User Verification Setup

User verification enables personalized portal experiences for your Confluence users, allowing them to see content tailored to their profile and permissions.

Prerequisites

To enable user verification for your Confluence macro you will require your Released Account ID and Shared Secret which can be found under Credentials within the Released app in Jira.

Configure in Confluence

1

Access Global Settings

• Click the Settings icon (⚙️) in Confluence

• Scroll down to Atlassian Marketplace section

• Click Released Portals

2

Enable User Verification

Toggle Enable User Verification to ON

3

Enter Your Credentials

• Account ID: Paste your Released account ID

• Shared Secret: Paste your shared secret

The system will automatically save and test the connection. If the connection fails, double-check your credentials

4

Add Trusted Domain

• After successful authentication, you'll see a Trusted Domain Required section

• Copy the displayed Forge domain (e.g., https://xxxxxxxx.confluence-connect.com)

• Add this domain to your Trusted Domains in the Released app in Jira.

📖 Learn more: Trusted Domains Configuration

How It Works

Once configured:

1. Automatic Authentication

   • When a Confluence user views a page with the Released macro, they're automatically authenticated

   • No additional login required

2. Personalized Content

   • Users see content based on their Released.so permissions

   • Feedback submissions, upvotes, and comments are tied to their identity

3. Profile Sync

   • User's Confluence display name and avatar are synced to Released

   • Ensures consistent identity across platforms

Security Notes

• The Shared Secret is stored securely using Forge's encrypted storage

• User emails are only accessed when User Verification is enabled

• Data is transmitted over HTTPS to Released.so's authentication API

• Only the current user's own data is shared (no access to other users' data)

---

Troubleshooting

Macro Doesn't Load

Symptom: The macro shows an empty state or doesn't display content

Solutions:

1. Verify Channel ID

   • Ensure your Channel ID is in the correct UUID format

   • Check for typos or extra spaces

   • Get the correct ID from Released.so → Settings → Integrations

2. Check Trusted Domains

   • Open your browser's developer console (F12)

   • Look for the warning: [Released] If the embed does not load...

   • Add your Confluence domain to Trusted Domains in Released.so

3. Clear Browser Cache

   • Hard refresh the page (Ctrl/Cmd + Shift + R)

   • Clear your browser cache and cookies

User Verification Not Working

Symptom: Users see "Email API access required" error

Solutions:

1. Verify Credentials

   • Go to Released Portals global settings in Confluence

   • Re-enter your Account ID and Shared Secret

   • Ensure the connection status shows "Authentication successful"

2. Check Trusted Domains

   • Verify the Forge domain is added to Released.so

   • The domain should match exactly (including https://)

3. Email Access Permissions

   • The app requires the read:email-address:confluence scope

   • This should be granted automatically during installation

   • If issues persist, try reinstalling the app

Configuration Not Saving

Symptom: Macro configuration doesn't persist

Solutions:

1. Invalid Channel ID

   • Ensure the Channel ID is a valid UUID format

   • The configuration dialog will show a red X if invalid

2. Browser Issues

   • Try a different browser

   • Disable browser extensions that might interfere

3. Confluence Permissions

   • Ensure you have edit permissions on the page

   • Check with your Confluence administrator

Support

Need help? We're here for you. Contact us at released.so/support