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 (warning) the word you want to use as hashtag hast to be unformatted (not bold, underlined, italic etc.)
  • Some macros (warning) Please note that not all macros work within the microblog. Especially if you insert them via copy / paste.

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.

You can not only reply to top-level microposts, but also to replies. Currently, no actually nested replies are created. Instead, your reply goes to the top-level post, but the post you refer to will be highlighted in the context and an @-mention will be inserted in the editor. Also, the editor now always shows up directly under the post you refer to so that you don't have to scroll through all the reply context.


Edit a micropost

By clicking the "edit" button, you get the well known editor to change your post.

After editing, the micropost is marked as "edited". You can open the version history by clicking this word.

The version history shows every change that was made.

You can edit your microposts to correct a typo, fix a link or whatsoever.
(info) Note that every Confluence administrator can also edit or remove your post!

After saving an edited micropost, it will be marked as "edited", so that others are aware that the post has been modified.

Click the "(edited)" link to show a version history overlay. It includes all modifications that have been made to this post, including date, time, the modifying user and the post contents.

Note that editing a micropost will not change the order of the timeline. The edited micropost will not be on top.

Delete a micropost

As a regular user you can delete your own microposts. Confluence or Space admins can also delete other users' microposts. But there is one rule: Only the last post of a conversation can be deleted at any given time. This rule applies to both regular users and admins. The idea behind this rule is to prevent anyone from distorting the meaning of a post by changing its context. 

If you want to remove a whole thread, you'll have to do so one post at a time.

Filter Topics and Search Function

With the sidebar you can filter which topics or spaces you want to see in your timeline. You can also search for content and hashtags within the filtered topics or spaces. 

You can choose between...

  • "Select all" - shows all content in permitted spaces and topics (preselection),
  • "Select none" - no content is shown,
  • 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.

(warning) The macro can be configured to restrict the topic filter to a given space. The search function is still available.

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


Open or hide this functions by clicking the loupe button



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 exist - in your Confluence wiki.
    (warning) Your admin has to configure at least one topic to get the microblog timeline to work - otherwise you are not able to write a micropost.

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 displayed 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.
    (warning) If you don't find the space you want to use you have to add a topic to this space in the administration first!
  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 for searching (and they still can hide it if you don't select this option).
  7. Limit number of microposts shown: Optionally enter the number of microposts displayed 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 displayed replies to each micropost - default is 3. When there are more replies to a micropost, they can be viewed 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 of 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)

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.

Receive your daily digest or instantly for every new post

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 maybe your confluence is behind a firewall), the daily digest or instantly email features are 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.

The subscribe button for Notifications by Email

The subscription dialog after clicking the watch button.

You can choose between a daily digest and an instantly email for every new post. You can also set the hour when you want to receive your daily digest.

In both cases, you will only receive an email notification for the selected topics or spaces.

(warning) Please note that your server time can differ from your local time ("current server time: 14:24" in the screenshot). So if your local time is 12:24 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. Please click this link if you want us to update this page. 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-media.net if you are in doubt, have a question, suggestion, or want changes from us.