Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

When Sharing a Confluence Page Isn't Your Best Option

As Confluence users, you know the situation: You've created a brand-new page and now you need to get your team involved to have them contribute or give feedback. 

You're faced with a few options. You could:

  • Share the page using the Share button (that's what it's there for, right?)
  • Comment (page or inline) with @-mentions
  • Or send a direct link to the page via synchronous communication channels like Slack

With so many ways to get your team's attention, which one should you use?

In this 3.5 min video below, we outline the best ways to get your team involved and engaged in Confluence and when to use which feature. Heads up: The handy 'Share' button isn't always the best choice! 

πŸŽ₯   Check it out: 

We also dive into each of these tips below πŸ‘‡ 

The Share Button

The Share button sits in the top right-hand corner of every Confluence page, and is the most obvious choice to share content. It's easy: click on Share, enter the team members (or groups) you want to inform, add a message, and hit send.

Using the Share button makes sense in two situations:

  • You want to inform your team members about a page and you want them to read it.
  • You want team members to edit the page.

In both cases, your aim is to notify your team members that they should take action: either read or edit the page.

So how does this differ from the other options? 

Comment With @-Mentions

Every time you want to engage your coworkers in a conversation about a page and encourage feedback and comments but not have them edit, then the Share button is not your best choice. Here's why.

When you share a page, think about that experience from the perspective of your team. The team member receives a message with your thoughts, questions or instructions about how or what they should provide feedback on. But when they want to provide that feedback – how or where should they do so?

They need to find a way to respond to your message on their own. It doesn't make sense to reply to the email notification, so they have to take an approach that feels best for them in that moment:

  • A page comment?
  • Maybe inline comments?
  • Maybe respond via email or send you a Slack message?

Without some kind of direction, you're looking at a mixed bag of feedback methods which won't work well for you or for your team.

So, when asking for feedback, this is what you should do: Create a comment on the page that contains your message and @-mention the teammates you want to involve. They'll still receive a notification, but now they can also respond to your instructions in the right way. What's more, other team members who later read the comments will better understand what was discussed and which decisions were made.

Check out this article for more best practices around commenting and feedback. 

Share as a Slack Message

Sharing a page or commenting with an @-mention is a very asynchronous way of getting coworkers involved due to the reaction time.

Before determining whether a Slack message is the way to go, it's important to understand the difference between synchronous and asynchronous communication – and the gray area in between. 

  • Synchronous Communication: Two or more people exchanging information at the same time. For example: phone calls, meetings, Zoom calls, collaborative editing on a Confluence page, etc. Synchronous communication has the advantage that it can be quicker because it is more interactive.
  • Asynchronous Communication: Refers to the exchange between two or more parties without the need for all the recipients to respond immediately. Emails are asynchronous, for example. Asynchronous communication has the benefit that your communication isn't disruptive of your team's immediate workflow. 

In between purely synchronous or asynchronous communication is a gray area, or rather a spectrum between the two extremes. The best example here is Slack.

Slack is actually an asynchronous communication tool, but it's often used in a synchronous way when users send messages and expect the recipients to answer right away, or if messages are sent back and forth quickly.

When you need to involve your team members more quickly, use a channel like Slack. But key word here is 'need' as this shouldn't be your share option by default.

⚠️ Beware: If your Slack messages contain too much information, you can easily find yourself in long, threaded conversations where feedback and decisions are easily lost in Slack.

If you decide to take the synchronous route by sharing in Slack, you should still create a Confluence page with more details and encourage any interaction or feedback to be left on that page. Slack should be seen as the more urgent notification channel, not as the primary medium for conversation or discussion. 

How Do You Engage Your Team in Confluence?

How do you literally get everyone on the same page? These are just some of the best practices and conventions that our team at K15t follows, but we'd love to hear how your team does it!

If you liked this article, you can read the complete version on Rock the Docs, our guide for technical documentation in Confluence. We also have plenty more Confluence best practices to share in the guide. Check it out πŸ‘‰ 



Log in or Sign up to comment
Community showcase
Published in Confluence

Confluence: Where work and wellness meet

Feeling overwhelmed by the demands of work and life? With a 25% increase in the prevalence of anxiety and depression worldwide during the pandemic, for most of us, it’s a resounding yes . πŸ™‹β€β™€οΈ ...

793 views 7 21
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you