Tutorial: Employee Directory

In this tutorial, you’ll build a Confluence page that displays employee contact information from Jira Assets. Viewers can browse through employees using a dropdown selector.

What you’ll create: A page showing an employee’s name, department, phone number, email address, and profile photo. A dropdown lets viewers switch between employees.

Prerequisites: An object schema in Jira Assets with a “Person” object type (or similar) that has attributes like Name, Department, Phone, Email, and Photo URL.

Step 1: Create the Filter

1. Edit a Confluence page
2. Insert a Beautiful Assets Filter macro
3. Configure it:
   • Name: Employees
   • Schema: Select your schema (e.g., “Company Directory”)
   • Object Type: Select “Person”
   • Optionally add a filter rule, for example Company = Brightpath Systems to show only that company’s employees
4. In the Results Preview, verify you see your employees
5. Check “Show object selection in View Mode” to add a dropdown so viewers can pick an employee
6. Click Save

Step 2: Add a Text Macro for Name

1. Insert a Beautiful Assets Text macro
2. Select the “Employees” filter
3. Select the “Name” attribute
4. Click Save

The employee’s name will display as inline text.

Step 3: Add a Text Macro for Department

1. Insert another Beautiful Assets Text macro
2. Select the “Employees” filter
3. Select the “Department” attribute
4. Click Save

Step 4: Add a Phone Macro

1. Insert a Beautiful Assets Phone Number macro
2. Select the “Employees” filter
3. Select the “Phone” attribute
4. Click Save

The phone number displays as a clickable tel: link that opens the user’s phone app.

Step 5: Add an Email Macro

1. Insert a Beautiful Assets Email macro
2. Select the “Employees” filter
3. Select the “Email” attribute
4. Click Save

The email address displays as a clickable mailto: link.

Step 6: Add an Image Macro

1. Insert a Beautiful Assets Image macro
2. Select the “Employees” filter
3. Select the “Photo URL” attribute
4. Click Save

Note: Only images from allowed domains will display.

Step 7: Publish and Browse

1. Click Publish
2. The page shows the first employee’s information
3. Use the object selection dropdown to switch between employees. All macros update automatically

Final Result

Your page now has:

• A dropdown to select any employee
• Their name and department displayed as text
• A clickable phone number
• A clickable email address
• A profile photo

All data is fetched live from Jira Assets on each page load.