draca

Troubleshooting

Data Not Loading

Symptoms: Macros show “Loading…” indefinitely, or display an error message.

Solutions:

  1. Check Jira Assets permissions: The viewer needs at least read-only access to the object schema being queried. Ask your Jira admin to verify permissions.
  2. Verify filter configuration: Edit the page, open the filter configuration, and check that the Results Preview shows data. If the preview is empty, adjust your filter rules.
  3. Check the AQL query: In advanced mode, ensure the AQL syntax is correct and all {Filter Name} references point to existing filters on the page.
  4. Check Jira connectivity: Beautiful Assets requires a working connection between Confluence and Jira. If Jira is down or unreachable, macros won’t load.

“Invalid License”

Symptoms: A license error message appears instead of data.

Solutions:

  • The app license has expired or the trial has ended
  • Contact your Atlassian workspace admin to renew or purchase a license through the Atlassian Marketplace

Symptoms: The object selection dropdown doesn’t appear on the published page.

Solutions:

  1. Edit the page and open the filter configuration
  2. Check that “Show object selection in View Mode” is enabled
  3. Verify the filter returns more than one result. The option is only available when multiple objects match

Table or List Shows Empty

Symptoms: The Table or List macro displays “No results” or appears empty.

Solutions:

  1. Edit the page and open the filter configuration (not the macro)
  2. Check the Results Preview. If it’s empty, the filter rules don’t match any objects
  3. Adjust filter rules or check if the underlying data in Jira Assets has changed
  4. For the List macro, ensure the filter has object selection enabled if it returns multiple objects

Slow Loading

Symptoms: Macros take a long time to load, or the page feels sluggish.

Solutions:

  1. Reduce results: Add more specific filter rules to return fewer objects
  2. Check admin limits: The Maximum Preview Results and Maximum Dropdown Items settings affect how much data is fetched
  3. Fewer macros: Each filter on the page triggers API calls. Consider whether you can consolidate filters or use a Table macro instead of many individual Text macros

Filter References Not Working

Symptoms: {Filter Name} placeholders show as errors in advanced mode.

Solutions:

  1. Verify the referenced filter exists on the same page and has the exact name you’re referencing (case-sensitive)
  2. Make sure the referenced filter is saved and configured. Unsaved filters won’t appear as valid references
  3. Filter names cannot contain { or } characters

Images Not Displaying

Symptoms: The Image macro shows a broken image or nothing.

Solutions:

  1. Check that the image URL uses one of the allowed domains
  2. Verify the attribute actually contains a valid URL (not just a filename)
  3. Test the URL directly in a browser to confirm the image is accessible