• Documentation

Insert the network macro

This macro was intentionally excluded from the new editor and will be deprecated from the legacy editor soon.

The Network macro displays a list of Network activity on a Confluence page or blog post. You can specify the user whose network activity you wish to show. These interactions include the users that the specified user is following or users who are following the specified user. The Network macro shows each listed user by their profile picture. It also provides a choice of two themes and the ability to limit the number of users in the list.

Use the Network macro

To add the Network 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 the Network 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.

Parameters

Parameters are options that you can set to control what and how content from the macro appears on the page. 

If the parameter name used in Confluence Cloud storage format is different than the label used when inserting macros using the browser or the slash command, it will be listed below in brackets (example).

Parameter

Default

Description

Username

Current user's username

The username of the Confluence user whose network interactions you wish to show. If no username is specified, then current user's (that is, your) network interactions are shown.

Mode

following

Determines which users are listed, with respect to the specified user:

  • following – those who the user is following.

    • followers – those who are following the user.

This parameter is unnamed in storage format and wikimarkup.

Theme

full

Determines how the user's network is displayed:

  • full – shows a large version of user's profile pictures and, if the following mode is set, provides an entry field function to follow more users.

    • tiny – shows only the small version of user's profile pictures.

Maximum Results

(max)

No limit imposed up to a maximum of 30

Restricts the number of users displayed. If the number of users exceeds the specified maximum, then a Show All link is provided. This link leads to the specified user's Network view, showing the complete list of network interactions.

Disabling the Network macro

The Network macro is provided by the 'network' module in the 'Profile Macros' plugin. To remove the macro from your site, you can disable the module in the plugin. See Disabling and enabling apps.

Wiki markup example

Wiki markup is only supported in the legacy editor.

Wiki markup is useful when you need to add a macro outside the editor, for example as custom content in the sidebar, header or footer of a space.

Macro name: network

Macro body: None.

1 2 3 4 {network:followers|username=admin|max=10|theme=full}

Still need help?

The Atlassian Community is here for you.