Microblogging for Confluence

Share information, have conversations, write messages and updates

See the documentation for your Release

Write a micropost

Mention a user by typing "@" and you'll get suggestions.

Choose a topic for your micropost.

The microblog editor to write a micropost is similar to the one used by Confluence for comments. Use it to share information and style your micropost.

You can use:

  • Text formatting
  • Links
  • Images
  • @ to mention a user
  • # to label / hashtag a micropost
  • Some macros ((warning) Please note that not all macros work within the microblog. Especially if you insert them via copy / paste.)

NEW since release 2.0: You also have to choose a microblog topic to store your micropost in ("Cat content" in the screenshot). In most cases, a suggested topic is preselected. If you cannot see the option to select a topic, the topic is predefined by context or macro configuration.

Reply to a micropost

Replying to a micropost uses the same editor as writing a new one.

Replying to a micropost is pretty much the same as writing a new one. By clicking the "Reply"-Button the related micropost will be moved to the top of the timeline and you can answer while seeing the context. Obviously, you can not change the microblog topic when writing an answer.

NEW since release 2.0: Topic sidebar

With the new topic sidebar you can decide which topic or space you want to see in your timeline.

The topic sidebar on the right

Show or hide the topic sidebar

You can choose between...

  • the "Global Timeline" to see all microposts from all spaces that you are permitted to view,
  • a space timeline (bold) to see all microposts in all topics inside this space,
  • or a topic timeline to see all microposts inside this topic.

Using the "Show / Hide topics" button you can show the sidebar or hide it to save some space for the micrpost contents.

(warning) The macro can be configured to restrict the topic sidebar to a given space.
The macro can also be configured to only show a given topic and not display the sidebar at all.
(See Configure Macro)

Updated in release 2.0: Inserting the macro / Inserting a timeline in a wiki page

Within the "Microblog Timeline" macro you have a powerful configuration to customize your timeline.

Add macro

2. Add "Other macro"

  1. Create or edit a page.
  2. Add "Other macro".
  3. Search for "microblog timeline" in the macro selector and add the "Microblog Timeline".
  4. Configure Macro (See Configure macro)
  5. Click on "Insert".
  6. Click on "Save". - You should see microposts - if any exists - in your Confluence wiki.

(warning) Please note:

  • Your admin has to configure at least 1 topic to get the microblog timeline to work - otherwise you are not able to write a micropost.
  • At the moment it is not possible to have more than one timeline on a page.
  • If you add a microblog timeline macro, the comments section is disabled on this page.

Configure macro


This shows a configuration for a "space timeline".

  1. Default timeline: Choose the default source for this microblog and configure which posts are shown initially.
    Depending on this configuration you have different parameters to set. (See Configuration combinations)
    1. Global: Initially shows the "global timeline" with posts from all spaces and topics.
    2. Space: Initially shows a "space timeline" with posts from the specified space.
    3. Topic: Initially shows a "topic timeline" with posts from the specified topic. The user can switch to other topics.
    4. Topic (without topic sidebar):  Shows a topic timeline with posts from the specified topic. The user can not switch to other topics.
      Note: The topic sidebar is disabled with this configuration.
  2. Space: Choose the space from which the microposts should be loaded.
  3. Default topic for posting: Select a topic where the microposts should be stored by default. When using a space timeline, the dropdown is restricted to topics from the specified space.
  4. Topic: Choose the topic from which the microposts should be loaded and where they should be stored by default.
  5. Restrict topic list: Should the topic list in the microblog be restricted to the selected space? When using a topic timeline, the topic list will be restricted to the space the specified topic is in.
  6. Hide topic sidebar: Initally hide the topic sidebar instead of showing it. Users can still expand the sidebar (and they still can hide it if you don't select this option).
  7. Limit number of microposts shown: Optionally enter the number of shown microposts on a page - default is 20 and max is 100. The limit applies to "parent" microposts, not to replies. When there are more posts in the microblog, a "Show more posts" link is displayed.
  8. Limit number of replies shown: Optionally enter the number of initially shown replies to each micropost - default is 3. When there are more replies to a micropost, they can be shown by clicking on a "X more replies" link.

(lightbulb) No worries: This configuration looks harder than it is. Just try it and use the preview button in the "Edit 'Microblog Timeline' Macro" view to see the results.

Configuration example

Configuring a so called "space timeline" which only shows microposts from every topic in the given space

This configuration creates a "space timeline" showing microposts from all topics the configured space "Third Microblog".

Posts will be saved to the topic "Off Topic" in the space "Third Microblog", if the user doesn't change the topic.

The topic sidebar will show all topics in all spaces, but is hidden by default.

No Microposts are shown in the preview, because there aren't any in this space so far.

Configuration combinations

 Space (2)Default topic for posting (3)Topic (4)Restrict topic list (5)Hide topic sidebar (6)Sidebar always hidden
Topic (without topic sidebar)(error)(error)(tick)(error)(error)(tick)

NEW since release 2.0: Microblog action

The microblog now has its own page where you can see the global timeline. You can get there by clicking the link in the application header.

The microblog action is also available under: http://<Confluence-URL>/plugins/microblog.action.


A typical notification after a user mentions you in a micropost.

If a user replies to your micropost or you get mentioned in a micropost, you'll get an email notification (if you configured your account to receive notifications).

The notification emails contain the micropost with complete context (i.e., all replies), and with all attached images.

You can directly view, answer and like the micropost.

Daily digest

The subscribe button for the daily digest on your global timeline.

If you want to know what is going on inside your confluence microblog, but you can't access your intranet because you are out of office (and e.g. your confluence is behind a firewall), the daily digest feature is what you are looking for.

Simply click the watch button on your global timeline and get an email with all unread posts.

(warning) If you cannot see the watch button, your administrator has disabled the daily digest feature of the microblog.

(warning) At the moment, this feature is only available for the global timeline (not for space or topic timelines).

The subscription dialog after clicking the watch button.

By clicking the checkbox you can subscribe to or unsubscribe from the daily digest. You can also choose the hour when you want to receive your daily digest.

(warning) Please note that your server time can differ from your local time ("current server time: 12:07" in the screenshot). So if your local time is 10:07 you are 2 hours behind your server time.


  • No labels

This content was last updated on 01/14/2020.

This content hasn't been updated in a while. That doesn't have to be a problem. Some of our pages live for years without becoming obsolete.

Old content can be incorrect, misleading or outdated. Please get in contact with us via a form on this page, our live chat or via email with content@seibert.group if you are in doubt, have a question, suggestion, or want changes from us.