tip/resting Created with Sketch.

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

Read the announcement for more information. 

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.

Screenshot: Network macro

Use the Network macro

To add the Network macro to a page:

  1. In the Confluence editor, choose  > Other Macros
  2. Find and select the required macro

(lightbulb) Type { and the beginning of the macro name to see a list of suggested macros.


To edit the Network macro

  1. Select the macro placeholder
  2. Select Edit. A macro dialog window will open, where you can edit the parameters of the macro.

Parameters

Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the browser, 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.


robotsnoindex
robotsnoindex

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.

{network:followers|username=admin|max=10|theme=full}