Documentation for Confluence 5.5.
Documentation for Confluence Cloud and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

You can publish a blog post from any space in Confluence, provided you have permission. Blog posts may be announcements, journal entries, status reports, or any other timely information.

To view the blog posts within a space: Go to a page in the space and choose Blog in the sidebar.
Or, if you are using the Documentation theme, choose Browse > Blog at the top of the screen.

Confluence lists the latest blog posts. You can click through to earlier posts via the navigation area in the sidebar.

Creating and editing a blog post is just as easy as creating and editing any other page in Confluence. You can also let people know you care by liking a blog post.

Creating a blog post

To create a blog post, you need the 'Add Blog' permission. See Space Permissions, and Creating Content

You can create attractive, engaging content in a blog post in the same way as in a page. See Creating Beautiful and Dynamic Pages.

On this page:

Related pages:

Editing a blog post

To edit a blog post, you need the 'Add Blog' permission. See Space Permissions.

To edit a blog post:

  1. Go to a page in the space and choose Blog in the sidebar.
    Or, if you are using the Documentation theme, choose Browse > Blog at the top of the screen. You will see the most recent blog posts within the space, and you can find earlier posts via the navigation area in the sidebar.
  2. Go to the blog post and choose Edit.
  3. Make changes to the blog post.
  4. (optional) Add a comment, in the text box below the editing pane, to describe your changes.
  5. Preview your changes if desired, and choose Publish.

Editing a blog post is similar to editing any other page in Confluence. However, there are a few things to keep in mind:

  • You cannot change the date of an existing blog post. You can only backdate when adding a blog post.
  • You cannot move a blog post to another space.
  • A blog post has no parent.

Moving a blog post

If you create a blog post in the incorrect space, or want to reorganise your spaces, you can move an individual blog post to another space. 

To move a blog post go to the post and choose Tools > Move and select the new destination space.

You will need the 'Delete blog' permission in the current space and 'Add blog' permission in the new (destination) space to do this. 

Deleting a blog post

By default, when you delete a blog post in Confluence, this will remove all versions of the post. To do that, you need the 'Delete Blog' permission. See Space permissions. If someone has applied page restrictions to the blog post, the restrictions may prevent you from deleting the post too. Deleted blog posts are stored in the space's trash and can be recovered by a space administrator.

If you want to delete a specific version of a blog post, you need to be a space administrator. When you delete a version of a blog post, the version is not stored in the trash. The deletion of a version is therefore permanent and cannot be undone.

To delete all versions of a blog post:

Go to the page and choose Tools > Delete. Confirm the action as prompted.
Note: The 'Delete' option will only appear if you have permission to delete this page.

To delete just one version of a blog post:

  1. Go to the page and choose Tools > Page History.

  2. Choose Delete next to the version you want to delete, and confirm the action as prompted.

Exporting a blog post 

You can export individual blog posts to PDF format. This is useful, for example, if you want to email an internal blog post to people outside your organisation. 

See Exporting Confluence Pages and Spaces to PDF for more information on exporting blog pages to PDF. 


  1. So how do I limit the display of each news item on the recent news page (i.e. viewrecentblogposts) - it seems to default to showing the full text of each posting.

    1. Hi Michael,

      I presumed you meant to say that, you do not want to view the full content of each posting news in Confluence. If this is the case, the workaround that i can think of is, the excerpt-include macro. You may want to give it a try and see if it does fulfill your requirement. An example would be:


      Hope the information does help.

      Choy Li

      1. Thanks Choy - the bog-posts macro will indeed work for a normal page (though I do wish Atlassian would enhance it provide formatting flexibility, I think this is one of the main reasons that Confluence isn't used for Blogging as much as it could be); but the built in recentblogposts page is really nice and what I'd like to do is restrict what it displays to excerpts.

        I'm loath to try to modify the underlying page (which I suspect will work) and was looking for a better way to control this.

  2. Hi,

    Just wondering if there is a way to copy news items from one space to another?

    Thank you.


    1. Hi Jyoti,

      Did you meant to say that , you want to copy all the news items that are available in one space and to migrate to another space? If this is the case, we are aware of such needs and there is a similar feature request being raised at:

      If you are keen on this feature, please do cast your vote to increase its popularity and add yourself as a watcher to the issue for future updates. Also, feel free to add comments to the feature to reflect the importance of this feature.

      Choy Li

      1. Yes please, I need that feature too. I've just been asked to migrate the contents, including news pages, of one space to another ..., ela

        1. Hi Elzbieta
          The best way to add your support for a feature request is to vote for the JIRA issue. We're delighted to receive suggestions for the documentation via comments on these pages, but they don't have much influence on the development of new or improved features in Confluence (smile)

  3. Anonymous


     I was wondering if there was a way to show the top 5 items of news on a page from another space.

     We have a page with the full list of items, but another page provides an overview of all spaces. In the overview page, I want to (not just link), but show the excerpts of top 3 news items.

    Is there a way of doing this?


    1. Hi,

      You can try to utilize the blog-post macro and limit the number of displayed news item of the particular space. For more info, please see:

      Hope this helps.


  4. Should be updated for the name change from news to blogs in 3.1?

  5. Anonymous

    What viewing permissions are set for blog entries?

    Do they inherit the space viewing permissions?

    How would i edit a blog entry such that only a limited set of users would be able to view it?



    1. Hi D,

      What viewing permissions are set for blog entries?

      Do they inherit the space viewing permissions?

      How would i edit a blog entry such that only a limited set of users would be able to view it?

      Yes, the blog post inherit the space viewing permission. You can edit the space permission so that a limited set of users would be able to view it.

      To learned more on the space permission please refer to this documentation:

      Hope that helps.
      Best rgds,

      1. Anonymous


        Are there any tickets open to change this feature such that viewing permissions could be granularly defined for each blog entry/object?



        1. Hi D,

          Indeed there is one feature request being raise in JIRA which is similiar to your requirement:

          Please add your comments to the discussion, vote on it and add yourself as a watcher for future updates. Also, please bear in mind the following document on how we schedule features for inclusion in our products: Implementation of New Features and Improvements.

          Hope that helps.
          Best rgds,

  6. Anonymous

    Question: How do I either completely disable the blogging feature across the entire site or if that's not possible, disable this feature on each space?

    1. Hi,

      I am afraid at the moment the feature to disable the blogging across the entire site is not available yet. Feel free to raise a feature request in JIRA:

      I have a mere suggestion, you might want to restrict all user to create blog post in space level using space permission. To learn more on space permission please refer to the following documentation:

      Hope that helps.

  7. Hi there,

    Is there any way to make a blog post sticky for the blog post macro? Or at least give the blog post macro a title, so people know whether they should add a new Page or a new Blog Post depending on their content.

  8. We have the effect that we cannot click the links to the other blog-posts in the blogpost-sidebar on the right side. The <a> links are there in the source code but they are not clickable. Also the links to the other months with blog-posts are not clickable. This situation does not show on every blogpost, even when I go on a month through the breadcrumb menu, the links work fine.

    We work with Confluence 4.3 in any browser.

    Anyone who can confirm this weird error?

    Thanks Thomas

    1. Hallo Williams

      I've had a look through our issue tracker and can't find any reports of this problem. Weird error indeed! Please would you contact our support team by raising a ticket at They can help you diagnose and fix the error.



      1. Anonymous


        This issue has been solved in

        Thank you for your assistance.

        / Thomas

  9. Anonymous

    Nice and wonderful article , i like all the detaisl and information and this blog and i wish more success for you

    Netbook Pas Cher

  10. how can i turn off wysiwyg and update html if i want to?

  11. hello,
    Thanks for the helpful contribution,
    thank you

  12. Anonymous

    Is there a way to have a workflow to publish blog post ?

    For example, some users (or everybody) are author and can write blog post but there are not publish.

    But only some users are editor and can review and publish the pending blog post.



  13. Hi there, 

    Just suddenly today the Blog Posts Macro has started reading, when previewing the marco, the page and/or saving the page.

    Error rendering macro 'blog-posts' : com.atlassian.renderer.v2.macro.MacroException

    I've re-built the search index, but that has not helped. We use Confluence On Demand 5.2. Can anyone help please? I use it a lot throughout a particular space. 



    1. Hi Sam,  This is unfortunately a bug. You can watch the progress of the issue here  CONF-29038 - Blog Post Macro throws com.atlassian.renderer.v2.macro.MacroException Resolved .  We hope to get a fix out as soon as possible.


      1. Great. Thanks alot. (smile)

  14. Anonymous

    I'm creating a blog and want to put a few lines of description at the top of the blog, underneath the title.  Is there any way to do this?  Thanks for your help!

  15. Anonymous

    We're in documentation format and I don't see any way of following the page you get to when you click browse>blog.

    I've tried making a page with a blog macro but it doesn't notify watchers when new blog posts are posted.  Is this a bug or is there some other way for users to watch blogs posts

      1. In your wiki, navigate to the blog's space.
      2. In the Confluence toolbar, select Browse > Advanced.
      3. In the Subscribe section, turn on Start watching space blogs.

      Hope this helps!

      ~Theresa (smile)

      1. Created an account..   I don't see advanced I guess this is just a permissions thing?

        1. Hi Matt, if you are trying to watch pages in this space, see my comment about the new Watch button. 

      2. Thanks for your comment Theresa. These instructions are correct for Confluence 4.3 and earlier.  

    1. Hi Anonymous, the steps for watching a blog depend on your theme and version of Confluence.  In the Documentation theme in Confluence 5.x go to Browse > Space Operations > Watch this blog

      If you are trying to watch blog posts in the Confluence documentation (this space), you can try out our new Watch button on any page which allows you to watch that page / blog, or all pages / blogs. This feature is available now to OnDemand customers and will be available in Confluence 5.2 for installed customers.  

  16. Anonymous

    Is there a way to force blog posts to users, e.g. when tagged as "mandatory"? I am looking for a way to manage important company announcments that we would need to push to all users without them having to sign up or the option to opt-out. Any ideas?

    1. Hi Anonymous,

      A strategy that we use internally is to have important blogs display on the Confluence dashboard. This is done by applying a label to particular blog posts (e.g. 'important-blog') and then adding the Blog Posts Macro to the dashboard, restricting the macro to display to just blog posts with the 'important-blog' label.  You can find out about editing the dashboard here - Editing the Site Welcome Message

      If you are an OnDemand customer you could also share the blog with a group (for example 'confluence-users' or 'staff'). All members of the group would receive an email prompting them to read the blog post, and a notification in the workbox.  This feature will be coming very soon for installed customers.

      You could also simply share the blog with a group / distribution email address if you have one, for example  

      Hope this gives you some ideas,  Rachel.

      1. Anonymous

        Hi Rachel,

        Thank you for your ideas and tips. They sound primising and I will give them a test to see, what works best. 


    2. Anonymous

      Hi Rachel,

      I was wondering if the feature you described above is avaiable for non on-demand clients yet? 

  17. Anonymous

    Is there a way to create a blog template?

  18. Is there a way to create a template for a blog?

    1. Hi Elise, sorry, Confluence does not support templates for blog posts. You can follow this issue  CONF-4174 - Use of Templates in Blog Posts Open  which will be updated if there are any plans to introduce this feature. 

      1. Thanks for the update. 

  19. Anonymous


    Is there a way to compose a blog and schedule it to "go out" days later?  It seems you can only back-date a post...

    1. Hi anonymous, sorry there is no way to schedule or back date blog posts. There is an issue for this feature request here that you might want to watch / vote on  CONF-5292 - Ability for news items to be posted at a certain date/time Open

  20. Anonymous


    Is there a way to reply to a blog post by commenting on a specific post (the way it's usually done with blogs) instead of by adding a comment to the page the blog is hosted on? Do you see what I mean? The comment feature appears to pertain to pages only but not to blog posts per se. Thank you.

    1. If you open the specific blog post, you will see a comments area at the bottom of the post.  

  21. Hi there.

    Is it possible somehow to display a notification in Confluence whenever a new blog-post for any spaces has been written? 

    Reason I ask is, I want to notify the users of new blog-post. I read in the comments above that  you solve this by displaying important new blog-post on the Dashboard, however people don't tend to use the Dashboard too much in my experience. I see the same in Jira. It would be cool if you could display a notification that there is a new blog-post, and from there on let the user manage which Space to watch or not.

  22. I use the "blog posts" macro for this purpose, placing it into an highlighted area on a popular page which almost everyone in our organization has set as its home page. Using parameters of the "blog posts" macro which let all blogs in this space to become listed for a small number of days.

    1. I hear you, but this requires users to set a page within Confluence as their homepage. In a place with 100+ eployees, this is a bit over the top to demand

      1. true

        In my case it made sense because our Collabnet's home page is not the dashboard but the home page of one of the spaces.

        (this resolves several other requests mentioned in other pages of this document space, likewise some people were asking "how do I customize the dashboard to include this or that information") . Though, this is not doable for onDemand users, as this is a site-wide configuration/decision.

  23. Anonymous

    Hello, is there a possibility to Blog on the mobil Version. Right now I saw only viewing is possible. Thanks Frank 

    1. That is correct.  You cannot add or edit pages on Confluence mobile.  Sorry.   You can comment and watch, but not actually create content. 

  24. Is it possible to:

    Receive notifications for new posts in a blog, but NOT receive notifications for comments on the blog post?

    1. Hi John, 

      It is possible to be notified of all new blog posts in your site (and not be notified of comments or changes).  Go to your Profile menu > Settings > Email and choose Subscribe to all blog posts

      This setting is different to watching a space or blog. The only downside is that the setting applies to all blogs across your whole site, and not just one specific space - so if you are wanting to be notified only of new blog posts in a specific space, it may not help.