support.atlassian.com Open in urlscan Pro
108.138.7.94  Public Scan

Form analysis
0 forms found in the DOM

Text Content

CONFLUENCE SUPPORT

 * Products
 * Documentation
 * Resources

 * Contact
 * 
 * Log in
 * 

 * 
 * Log in
 * 

Cloud
Data Center
 * Jira Software
 * Jira Service Management
 * Jira Work Management
 * Jira Align
 * Confluence
 * Trello
 * Bitbucket
 * Opsgenie
 * Statuspage
 * Atlas
 * Halp
 * Advanced Roadmaps for Jira
 * Team Calendars
 * Questions for Confluence
 * Atlassian Cloud
 * Atlassian Analytics
 * Compass
 * Jira Product Discovery

 * Set up Confluence Cloud
   
   Get the high-level details you need to set up your Confluence Cloud site in
   order to meet your team's needs.

 * Create and organize work in Confluence Cloud
   
   Learn how to create great content and organize it.

 * Collaborate on content and get notified in Confluence Cloud
   
   Learn how to collaborate on pages and blogs, get notified about activity, and
   view analytics to see how content is performing.

 * Manage your account and permissions in Confluence Cloud
   
   Adjust settings around who can see what content on your site and what actions
   they can perform on it.

 * Administer Confluence Cloud sites
   
   Find everything a site admin needs to know to keep their Confluence Cloud
   site running smoothly.

 * Extend the functionality of Confluence Cloud
   
   Get an overview of the macros and premium features that extend Confluence
   functionality.

 * Community
   
   Answers, support and inspiration

 * System Status
   
   Cloud services health

 * Suggestions and bugs
   
   Feature suggestions and bug reports

 * Marketplace
   
   Product apps

 * Billing & licensing
   
   Frequently asked questions

Products
Documentation
Resources
 * Log in to account
 * Contact support
 * Training & Certification
 * Atlassian Migration Program
 * GDPR guides
 * Enterprise services
 * Atlassian Partners
 * Developers
 * Success Central
 * User groups
 * Automation for Jira
 * Atlassian.com

Confluence Cloud

Documentation

 * 
   Set up Confluence Cloud
   * 
     Learn how Confluence Cloud works
     * What is Confluence Cloud?
     * Learn about the features of Confluence Cloud plans
     * Confluence Standard
   * 
     See how teams use Confluence Cloud
     * Use Confluence for technical documentation
     * Use Confluence for software teams
 * 
   Create and organize work in Confluence Cloud
   * 
     Navigate around Confluence
     * Use Home to jump into work and see what's happening
     * Confluence navigation
   * 
     Find content in Confluence Cloud
     * Search for pages and posts
     * Search the people directory
     * Confluence search syntax
     * Discover relevant content with related pages
     * Use Atlassian Intelligence to search for answers
   * 
     Use spaces to organize your work
     * Create a blank space
     * Customize your personal space
     * Create a space from a template
     * Choose a space key
     * Navigate spaces
     * Organize your space
     * Find pages in a space
     * Customize your space's overview
     * Use labels to categorize spaces
     * Customize your space
     * Archive a space
     * Delete a space
   * 
     Create and edit content
     * Create, edit, publish, and update a page
     * Format your page
     * Insert elements into a page
     * Make your page and its title more memorable
     * Add a status to your page or blog
     * Smart Links in Confluence
     * View a page
     * Use symbols, emojis, and special characters
     * Keyboard shortcuts and autocomplete
     * Available markdown commands
     * Import external documents
     * Create a custom report
     * Confluence Cloud editor roadmap
     * Convert pages to the new editor
     * Transfer ownership of your page to another person
     * What data is sent and received when pasting a Smart Link?
     * What is the new and improved publishing experience?
     * Manage your storage usage
     * Use Atlassian Intelligence to help write or edit content
   * 
     Pre-format your content with templates
     * Create a page from a template
     * Create a template
     * Edit a template
     * Promote a template
     * Delete or disable a template
   * 
     Upload and manage files
     * Upload a file
     * Display files and images
     * Manage uploaded files
     * Share and comment on files
   * 
     Keep content organized
     * Manage your content tree
     * Take quick action from the page title
     * Use labels to organize pages and attachments
     * Move, copy, and hide pages
     * Archive pages
     * Restore archived pages to the page tree
     * Delete, restore, or purge a page
     * Save a page for later
   * 
     Export content from Confluence Cloud
     * Export content to Word, PDF, CSV, HTML, and XML
     * Customize exports to PDF
     * Advanced PDF export customizations
     * Create a PDF using a custom font
     * Wide tables may be cut off in PDF export
     * Cases where PDF Export may revert to using legacy exporter
   * 
     Atlassian Intelligence features in Confluence Cloud
     * Search for answers using Atlassian Intelligence
     * Write or edit content using Atlassian Intelligence
     * Summarize a page or blog using Atlassian Intelligence
     * Define terms using Atlassian Intelligence
     * Use Atlassian Intelligence with Confluence automation
     * Learn about pre-defined prompts in Atlassian Intelligence
   * Create and collaborate on live-edit pages in Confluence
   * 
     Create and edit whiteboards
     * Getting started with Confluence whiteboards
     * Create a new whiteboard
     * Organize and explore ideas with sticky notes
     * Add and edit text on whiteboards
     * Build flows and diagrams with flows and connectors
     * Use shapes to visualize ideas
     * Navigation tools in whiteboards
     * Inserting links to your whiteboard
     * Use sections to organize your work
     * Add the feels with stamps and stickers
     * Add and edit images on whiteboards
     * Use a template to get started fast
     * Organize your whiteboards in the content tree
     * Integrate whiteboards into your Atlassian workflow
     * Link Jira issues from your whiteboard
     * Take bulk Jira actions with smart sections
     * Keep on track with the timer
     * Find your whiteboards
     * Add or remove whiteboard restrictions
     * Collaboration limits on whiteboards
     * What Confluence whiteboards don't support
     * Whiteboards impact on third-party apps
     * Whiteboards beta updates
     * Understand Confluence whiteboards plans and features
   * 
     Getting started with Confluence databases
     * Changes to your EAP database experience
     * Database impact on third-party apps
   * Present your content with Presenter mode
 * 
   Collaborate on content and get notified in Confluence Cloud
   * 
     Collaborate on content
     * Create a network of users
     * Add a reaction to any content
     * Mention a person or team
     * Share a page, whiteboard, or blog post
     * Comment on pages and blog posts
     * Watch pages, spaces, and blogs
     * Manage watchers
     * Add people to Confluence from Google, Slack, or Microsoft
     * Invite guests to Confluence
     * Assign space access to guests
     * What can guests see and do in Confluence?
     * Share content externally with public links
   * 
     Get notified about content and activity
     * View your notifications
     * Subscribe to email notifications
     * What is a Confluence RSS feed?
     * Build an RSS feed
     * Subscribe to pre-specified RSS feeds
     * Subscribe to a network RSS feed
   * 
     View Confluence analytics to see how content is performing
     * View insights on your site
     * View insights on spaces
     * Page insights and analytics
     * Set viewing permissions for analytics
 * 
   Manage your account and permissions in Confluence Cloud
   * 
     Manage your account
     * Edit your profile
     * Edit your user settings
     * Change your Confluence password
     * Manage OAuth access tokens
     * Delete your account
     * Change your theme
     * Removing users and downgrading to Confluence Free
     * Set your email visibility
   * 
     Learn about Confluence Cloud permissions
     * What are Confluence Cloud permissions and restrictions?
     * Manage permissions in the Free plan of Confluence Cloud
   * 
     Manage site-level permissions
     * What is a Confluence group?
     * Manage global permissions
     * What happens when an account is deactivated vs. deleted?
     * Share your instance externally with anonymous access
     * Inspect a user's permissions
     * Bypass access restrictions on a page with admin key
     * View the audit log
     * How secure are public links?
     * Set up and manage public links
   * 
     Manage permissions on the space level
     * What are space permissions?
     * Assign space permissions
     * Share a space externally with anonymous access
     * Give access to unlicensed users from Jira Service Management
     * Copy Space Permissions
   * 
     Manage permissions on the page level
     * Add or remove content restrictions
 * 
   Administer Confluence Cloud sites
   * Get started as Confluence Cloud administrator
   * 
     Migrate a Confluence Cloud instance or space
     * Migrate a Confluence Cloud instance or merge instances from multiple
       sites
     * Migrate from Confluence Cloud to Data Center
     * Import a Confluence Cloud space
     * Export a data backup file of your instance
   * 
     Configure Confluence Cloud
     * Configure the indexing language
     * Enable OpenSearch
     * Configure number formats
     * Configure shortcut links
     * Configure time and date formats
     * Enable threaded comments
     * Disable reactions
     * Configure Captcha for spam prevention
     * Hide external links from search engines
     * Disable anonymous access to remote API
     * Configure the autosave interval for drafts
     * Configure attachment size
     * Configuring an admin announcement banner
   * 
     Change the look and feel of Confluence Cloud
     * Change your site and space logos
     * Customize a site's color schemes
     * Install a theme
     * Apply an Admin-driven theme to a site
   * 
     Change the default behavior and content
     * Change the site title
     * Configure the administrator contact page
     * Configure the site homepage
     * Customize default space content
     * Edit the site welcome message
     * Choose a default language
     * Confluence wiki markup syntax
   * 
     Administer global templates
     * Create a global template
     * Delete or disable a global template
     * Edit a global template
     * Install a global blueprint
   * Transfer ownership of a page from one user to another
 * 
   Extend the functionality of Confluence Cloud
   * 
     Use macros to show Confluence content on pages
     * 
       What are macros?
     * Learn which macros are being removed
     * Insert the attachments macro
     * Insert the blog posts macro
     * Insert the Change History macro
     * Insert the child pages macro
     * Insert the content by label macro
     * Insert the content report table macro
     * Insert the contributors macro
     * Insert the contributors summary macro
     * Insert the create from template macro
     * Insert the decision report macro
     * Insert the excerpt macro
     * Insert the excerpt include macro
     * Insert the include page macro
     * Insert the labels list macro
     * Insert the network macro
     * Insert the popular labels macro
     * Insert the profile picture macro
     * Insert the recent updates macro
     * Insert the recently updated dashboard macro
     * Insert the related labels macro
     * Insert the spaces list macro
     * Insert the task report macro
     * Insert the user profile macro
   * 
     Use macros to add development info on Confluence pages
     * Insert the code block macro
     * Display Jira issues in a table
     * Insert the Jira chart macro
     * Insert the Jira timeline macro
     * Display your Assets data on a Confluence page
   * 
     Use macros to include media on Confluence pages
     * Insert the Google Drive macro
     * Insert the Microsoft OneDrive for Business macro
     * Insert Microsoft Office macros
     * Insert the multimedia macro
     * Insert the PDF macro
     * Insert the widget connector macro
   * 
     Use macros to add navigation on Confluence pages
     * Insert the anchor macro
     * Insert the Live search macro
     * Insert the navigation map macro
     * Insert the page index macro
     * Insert the page tree macro
     * Insert the page tree search macro
     * Insert the table of contents macro
     * Insert the table of content zone macro
   * 
     Use macros to add reporting info to Confluence pages
     * Insert the page properties macro
     * Insert the page properties report macro
     * Insert the user list macro
   * 
     Use macros to add visuals and images to Confluence pages
     * Insert the chart macro
     * Insert the gallery macro
     * Insert the iFrame macro
     * Insert the roadmap planner macro
   * 
     Review macros only available in the legacy editor
     * Insert the cheese macro
     * Insert the column macro
     * Insert the content by user macro
     * Insert the create space button macro
     * Insert the expand macro
     * Insert the favorite pages macro
     * Insert the global reports macro
     * Insert the IM presence macro
     * Insert the info, tip, note, and warning macros
     * Insert the JUnit report macro
     * Insert the noformat macro
     * Insert the panel macro
     * Insert the recently used labels macro
     * Insert the search results macro
     * Insert the section macro
     * Insert the space attachments macro
     * Insert the space details macro
     * Insert the status macro
     * Insert the lorem ipsum macro
   * 
     Use gadgets to add dynamic content
     * Add the activity stream gadget
   * 
     Use Confluence with other applications
     * Manage your apps
     * Use Slack and Confluence together
     * Use Jira and Confluence together
     * Use Trello and Confluence together
     * Use Microsoft Teams and Confluence together
   * 
     Use Team Calendars for Confluence (Premium feature)
     * Subscribe to Team Calendars from third-party calendars
     * Getting started with team calendars
     * Restrict a calendar
     * Add events
     * Add Jira events
     * See standard event types
     * Add and delete custom event types
     * Add reminders to events
     * Embed calendars on Confluence pages
     * Watch a calendar
     * Subscribe to Team Calendars from Apple Calendar
     * Subscribe to Team Calendars from Thunderbird
     * Subscribe to Google Calendars from Confluence
     * Subscribe to Team Calendars from Google Calendar
     * Subscribe to Team Calendars from Microsoft Outlook
     * Subscribe to Team Calendars from Apple iOS Calendar
     * Export to other calendars
     * Delete or remove a calendar
     * Set system properties
     * Team Calendars FAQs
     * Subscribe to Team Calendars from Google Calendar (Android)
   * 
     Use Questions for Confluence
     * Get started with Questions for Confluence
     * Install Questions for Confluence
     * What are Questions permissions?
     * Ask a question
     * Watch and edit topics
     * What are votes and experts?
     * Integrate questions with your spaces
     * Administer Questions
   * 
     Use automation for Confluence (Premium feature)
     * What is Confluence automation?

Atlassian Support
/
Confluence
/
Resources
/
Extend the functionality of Confluence Cloud
/
Use macros to show Confluence content on pages
Cloud
Data Center




WHAT ARE MACROS?

Using macros helps you to extend the capabilities of your Confluence pages,
allowing you to add extra functionality or include dynamic content. For example,
use the Attachments macro to list files attached to a page, or use the Widget
Connector macro to include things like a YouTube video or Twitter feed.


ADD A MACRO TO YOUR PAGE

To add a macro:

 1. When editing, select from the toolbar

 2. Find the macro by name and select it

 3. Configure it as needed

You can also type / on the page to bring up the same list you'd see by
selecting from the toolbar. Continue typing the name of the macro to filter the
list.

To edit a macro:

 1. Select the macro placeholder.

 2. Select the Edit icon to open the configuration panel.

 3. Configure the parameters. Your changes are saved as you go.

 4. Resume editing the page, and the panel closes.

You can also select the centered , medium-width , and full-width icons to adjust
the width of some macros. Select the trashcan iconto remove the macro.


MACRO PARAMETERS

Many macros have optional parameters you can use to control the macro's output.

With the Attachments Macro, for instance, you have two optional parameters
allowing you to:

 * Specify the file formats of the attachments displayed

 * Choose whether or not you want old versions of the attachments displayed


MACRO PLACEHOLDERS

Macro placeholders are displayed in the editor where you have added a macro to
the page.

When editing a page, you can:

 * Double-click a macro placeholder (or click the placeholder and choose Edit)
   to open the macro dialog window and edit the macro's parameters

 * Select a macro placeholder to cut, copy and paste the macro


CONFLICTS BETWEEN TWO MACROS

Some Marketplace macros, or apps, can’t be installed together because they were
given the same internal ID. When you try to install an app with a name that
conflicts with a previously installed macro, you will see this error message:

Unable to install <app B>
Your instance has <app A> from the same partner that does not allow installation
of ‘App B’ due to technical constraints.

The quickest solution is to uninstall one app so that you can install the other.

You may also want to contact the developer through the Atlassian Marketplace and
ask them to address the error.


MACROS IN THE LEGACY EDITOR ONLY

Below is a list of the macros available in the legacy editor.

Select a macro name for details of the usage, including optional parameters and
examples.

 * Cheese Macro

 * Code Block Macro

 * Column Macro

 * Content by User Macro

 * Create Space Button Macro

 * Expand Macro

 * Favorite Pages Macro

 * Global Reports Macro

 * Google Drive macros

 * IM Presence Macro

 * Info, Tip, Note, and Warning Macros

 * JUnit Report Macro

 * Loremipsum Macro

 * Multimedia Macro

 * Navigation Map Macro

 * Noformat Macro

 * Panel Macro

 * Recently Used Labels Macro

 * Search Results Macro

 * Section Macro

 * Space Attachments Macro

 * Space Details Macro

 * Status Macro

For alternate methods for accomplishing the goal of older macros, learn which
macros are being removed.


MACROS AVAILABLE IN BOTH EDITORS

Below is a list of the macros available in both editors.

Select a macro name for details of the usage, including optional parameters and
examples.

 * Anchor Macro

 * Attachments Macro

 * Blog Posts Macro

 * Change-History Macro

 * Chart Macro

 * Children Display Macro

 * Content by Label Macro

 * Content Report Table Macro

 * Contributors Macro

 * Contributors Summary Macro

 * Create from Template Macro

 * Excerpt Include Macro

 * Excerpt Macro

 * Gallery Macro

 * iFrame Macro

 * Include Page Macro

 * Microsoft Office macros

 * Jira Chart Macro

 * Jira Issues Macro

 * Jira Roadmap Macro

 * Labels List Macro

 * Livesearch Macro

 * Microsoft OneDrive for Business Macro

 * Network Macro

 * Page Index Macro

 * Page Properties Macro

 * Page Properties Report Macro

 * Page Tree Macro

 * Page Tree Search Macro

 * PDF Macro

 * Popular Labels Macro

 * Profile Picture Macro

 * Recently Updated Dashboard Macro

 * Recently Updated Macro

 * Related Labels Macro

 * Roadmap Planner Macro

 * Spaces List Macro

 * Table of Contents Macro

 * Table of Content Zone Macro

 * Task Report Macro

 * User List Macro

 * User Profile Macro

 * Widget Connector Macro


MACROS FROM THE MARKETPLACE

Many more macros are available from the Atlassian Marketplace.

 

Was this helpful?

Yes
No
It wasn't accurate

It wasn't clear

It wasn't relevant
Provide feedback about this article


ADDITIONAL HELP

Ask the Community
 * Use macros to show Confluence content on pages

 * What are macros?

 * Learn which macros are being removed
 * Insert the attachments macro
 * Insert the blog posts macro
 * Insert the Change History macro
 * Show more

On this pageAdd a macro to your pageMacro parametersMacro placeholdersConflicts
between two macrosMacros in the legacy editor onlyMacros available in both
editorsMacros from the Marketplace
CommunityQuestions, discussions, and articles
 * Your Privacy Choices
 * Privacy Policy
 * Terms of Use
 * Security
 * 2024 Atlassian

This site uses cookies to improve your browsing experience, perform analytics
and research, and conduct advertising. To change your preferences, click Manage
preferences. Otherwise, clicking Accept all cookies indicates you agree to our
use of cookies on your device. Clicking Reject all cookies means you do not
agree to our use of non-strictly necessary cookies on your device.Atlassian
Cookies and Tracking Notice
Manage preferences Reject all cookies Accept all cookies



MANAGE PREFERENCES

When you visit any website, it may store or retrieve information on your
browser, mostly in the form of cookies. This information might be about you,
your preferences or your device and is mostly used to make the site work as you
expect it to. The information does not usually directly identify you, but it can
give you a more personalized web experience. Because we respect your right to
privacy, you can choose not to allow some types of cookies. Click on the
different category headings to find out more and change our default settings.
However, blocking some types of cookies may impact your experience of the site
and the services we are able to offer.
More information
Accept all

STRICTLY NECESSARY COOKIES

Always Active

These cookies are necessary for the website to function and cannot be switched
off in our systems. They are usually only set in response to actions made by you
which amount to a request for services, such as setting your privacy
preferences, logging in or filling in forms. You can set your browser to block
or alert you about these cookies, but some parts of the site will not then work.
These cookies do not store any personally identifiable information.

TARGETING COOKIES

Targeting Cookies

These cookies may be set through our site by our advertising partners. They may
be used by those companies to build a profile of your interests and show you
relevant adverts on other sites. They are based on uniquely identifying your
browser and internet device. If you do not allow these cookies, you will
experience less targeted advertising.

FUNCTIONAL COOKIES

Functional Cookies

These cookies enable the website to provide enhanced functionality and
personalisation. They may be set by us or by third party providers whose
services we have added to our pages. If you do not allow these cookies then some
or all of these services may not function properly.

PERFORMANCE COOKIES

Performance Cookies

These cookies allow us to count visits and traffic sources so we can measure and
improve the performance of our site. They help us to know which pages are the
most and least popular and see how visitors move around the site. If you do not
allow these cookies we will not know when you have visited our site, and will
not be able to monitor its performance.

Back Button


COOKIE LIST



Search Icon
Filter Icon

Clear
checkbox label label
Apply Cancel
Consent Leg.Interest
checkbox label label
checkbox label label
checkbox label label

Reject all Confirm my choices