draca

Getting Started

This guide walks you through installing Beautiful Assets and creating your first page with live Jira Assets data.

Prerequisites

  • A Confluence Cloud instance with Jira Service Management (or Jira Assets)
  • At least one object schema with objects in Jira Assets
  • Admin access to install apps (or ask your admin)

Step 1: Install from the Atlassian Marketplace

  1. Go to Confluence Settings > Find new apps (or visit the Atlassian Marketplace)
  2. Search for Beautiful Assets
  3. Click Install and follow the prompts
  4. The app is now available in the Confluence macro browser

Step 2: Add a Filter Macro

  1. Open a Confluence page and click Edit
  2. Type /Beautiful Assets Filter or open the macro browser and search for it
  3. Insert the Beautiful Assets Filter macro

The filter configuration panel opens automatically.

Step 3: Configure the Filter

  1. Enter a Name for your filter (e.g., “Employees”)
  2. Select an Object Schema from the dropdown
  3. Select an Object Type (e.g., “Employee”, “Computer”, “Server”)
  4. Optionally add filter rules to narrow results (e.g., Status = Active)
  5. Check the Results Preview to verify you see the expected objects

Filter configuration

  1. Click Save

Step 4: Add a Display Macro

  1. Below or next to the filter macro, type /Beautiful Assets Text (or any other display macro)
  2. In the macro configuration:
    • Select the filter you just created from the Filter dropdown
    • Choose which attribute to display (e.g., “Name”, “Email”, “Department”)
  3. Click Save

Adding a text macro

Step 5: Publish and View

  1. Click Publish on the Confluence page
  2. The filter fetches data from Jira Assets and the display macro shows the attribute value

Published page with live data

If the filter returns multiple objects, consider enabling object selection on the filter. This adds a dropdown on the published page so viewers can browse through objects.

What’s Next