Tips & Tricks: Using Metadata Macros

Getting to grips with a new app can sometimes be challenging. But, once you understand the power of Metadata Macros for Confluence, you'll discover just how much more efficient and informed your work can be. Here are some tips and tricks to help you get the most out of our app.

Utilize Context Labels

Context labels are your best friend when it comes to making your metadata understandable to others. Use context labels to provide brief descriptions or explanations of the metadata you are displaying. This makes the information accessible to everyone, even those unfamiliar with the context.

Combine Multiple Macros on One Page

There's no limit to how many macros you can use on a single page. Don't be afraid to use multiple macros to display a rich array of metadata that provides a comprehensive picture of the page or space context.

Leverage the Power of Analytics

If you're on a premium plan, make the most out of the Analytics Metadata Macro. By showing the total views and unique viewers of a page, you can gain insights into your page's reach and audience engagement.

Personalize Date and Time Formats

Remember, you have the power to choose how you want to display dates and times. Customize your date and time formats based on your audience and their familiarity with different formats.

Use the Right Macro for the Right Job

Each macro has its specific use case, so make sure you're using the right one for your needs. For instance, the Page Metadata Macro is great for a broad overview of a page, but for version-specific details, you'll want to use the Page Version Metadata Macro.

Stay Updated with Atlassian Issues

Atlassian Forge, the platform we use to build our app, may sometimes have bugs that affect our app's functionality. Stay updated with known issues through the Atlassian Jira platform. For instance, as of now, there's a limitation on inserting metadata inline in a page text due to a known issue. You can check the progress of this issue here.

Use Page and Space IDs for Reference

Page and Space IDs are unique identifiers that can be used for specific referencing. They can be particularly useful for scripting, automation, or for cross-referencing pages or spaces in a large Confluence instance.

Export with Confidence

When you export a Confluence page, all metadata displayed by our macros is included in the export. This ensures you don’t lose any important metadata when you take your content outside of Confluence.