User Guides

Mattermost

Read this document to get familiar with Mattermost. It is used to communicate with XR groups as well as have 1-to-1 conversations.

If you need support with:

Please join one of the weekly sessions:

Mondays 17:30-18:00 (quick questions)

Thursdays 18:30-19:30 (longer training)

Join Zoom Meeting https://us02web.zoom.us/j/89528558324?pwd=R0JWZUovZk8zUy9RMXRjZGFGTmJaUT09

Meeting ID: 895 2855 8324 Passcode: 278766

First Steps

Getting Access

Before you can access Mattermost you first need to sign up to the XR UK Communications Hub. For instructions on how to do this, please read this guide.

Once you are on the Hub, there are a few ways to access Mattermost:

  1. Click on the Mattermost icon from the Comms Hub main page.

 https://imgur.com/j3Z1uMF

  1. Type https://organise.earth into your browser and hit Enter.

Once this is done, we recommend adding the page to your bookmarks/favourites so it's easier to find in future.

Note: Mattermost is also available as an app so you can install it to your smartphone or tablet. Please read this document for instructions on how to do this.

Landing Page

When you have logged in to Mattermost, you will see a screen that looks a lot like this:

Mattermost-screen-clean-smaller.png

Note that we have added numbers to the screenshot and we will refer to this image throughout the document.

Basic Navigation

Watch this 5 minute video for an introduction on finding your way around Mattermost.

Teams

Teams in Mattermost are basically collections of Channels. Teams appear on the far left of your screen (1). Click to switch between them.

You will be added to the UK Team by default but your group might use other Teams — you will see these too.

Checking who else is in my Team

To see the other members of a Team, click on the Main Menu (3) and select View Members.

Joining other Teams

UK Circles with their own Team can be contacted via their Reception Channel in UK Team.

To join a public Team, click on the + sign next to your list of Teams (1) and then click "Browse Channels". This will bring up a list of all the other XR public Teams you are able to join, including for other countries. Click on one of the list of Teams to add yourself.

If you want to be added to a private Team (e.g. for your local group), you will need to speak to a Group Admin/Tech Champion who will be able to send you an invite.

Leaving a Team

To leave a Team, open the Main Menu (3), and then select the option Leave Team.

Note that once you have left a Team, if you want to re-join at any point, you will have to join (or be invited to) all the Channels you belong(ed) to previously.

Channels

Channels are just another name for group chats. Every local group/working group set up on the Hub will have several of these Channels that you will be added to if you are part of that group.

Note: For a walkthrough of Channels, you can watch the Finding and Joining Channels video (4 mins).

Type of Channels

IRCChannel-public-private-icons.PNG Most Channels are public, so anyone in the Team can join them. They have a picture of the globe next to them. Some Channels are private, by invitation only, and they have a padlock next to them.

Joining Channels

To join a public Channel, either click in Find Channel and search, or click the + button to browse Channels on the left (4). This will bring up a list of all of the public Channels in your Team. Click on any of these in the list to add yourself.

To join a private Channel, you should ask someone already in that Channel to add you. You could also post a message in that group's reception Channel asking to be added.

Leaving a Channel

To leave a Channel, click its name at the top of the screen (not where it appears lower down on the left) and then select the option Leave Channel. Alternatively, if you hover over the Channel lower down on the left, three dots will appear next to it — from that menu, select Leave Channel.

Muting Channels

You can mute Channels if you want to stop receiving notifications from it but don't want to leave. To do this, click the Channel heading (at the top of the screen), or hover over the Channel lower down on the left and click the three dots, and then click Mute Channel. You can also set whether you want to be notified if someone uses @all or @channel in Settings (11).

Default Channels

Every Team has two default Channels that you will be added to when you are added to the team:

Very Important: Please do not rename these default Channels as it will cause a lot of confusion.

Note: It is not possible to leave the Town Square Channel. If you want to stop receiving notifications, you should mute the Channel instead.

Sorting Channels

If you hover over the Channels header on the lower left (5), by clicking on the three dots that then appear, you can sort your Channels in one of three ways:

In addition, you can Create New Category which enables you to sort Channels into groups that suit you, e.g. relating to particular projects or areas of interest. Once you have created your categories, you can drag and drop Channels between them.

Contacting other groups

All XR UK groups on Mattermost have a public 'Reception' Channel in the UK Team, and their members will be added to them by default (you will probably be in some yourself). This lets rebels from other groups find and speak to them.

To join someone else's reception Channel, go to the UK Team, click Find Channel or + (4), to search or browse for the Channel you want to join and then click Join. The Channel will then appear in your Channels list.

Creating Channels

Important: You should not create public Channels from inside Mattermost. Instead, please get your Group Admin/Tech Champion to do this for you using the Hub.

To create a private Channel:

  1. Click on the + sign next to the Main Menu (3)
  2. Select 'Create New Channel'
  3. Enter a name for the new Channel (and optional Purpose and Header), ensuring that 'Private' is selected
  4. Click Create Channel

Channel headers (7)

Underneath the Channel name at the top of the page is the Channel header. It is a useful place to put information about what the Channel is for and to store some useful links (e.g. your group's Forum or your regular Zoom meetings).

To see all the info, click on the Channel name:

6FXChannel-info.PNG

then click on View Info.

If you want to change what is written in the header, click on Edit Channel Header. If you want to add links to this section, the process is the same as here. Please confirm with your Group Admin before making any change to the Header.

Sending Messages (15)

You can write messages by typing in the box at the bottom of the screen. To send them hit Enter. The message will be sent to the Channel or Direct Message you are currently in.

Alerting people to messages

If you want a particular person to read a message you are sending, you can tag them by writing '@' followed by their username (e.g. @xrukadmin). This will send them a notification.

Important: You can also use @all or @channel to notify everyone in a Channel but please use this responsibly as for larger groups it is rarely appropriate and may annoy people.

Sending Direct Messages (6)

To send someone a Direct Message (instead of posting in a Channel):

  1. Click the + sign to the right of the heading DIRECT MESSAGES to the left of the screen (6)
  2. Select the users you want to message (up to a maximum of 6)
  3. Write and send your message

All of the Direct Message conversations that you have had will appear below the DIRECT MESSAGES heading to make it easier to contact them again. Next to each name, an icon shows whether they are online or not. Clicking on a username will display your Direct Message history with that user. Users you do not need to contact regularly can be removed from this list by pressing the cross to the right of their name.

Sorting your Direct Messages

Much like with Channels, Direct Messages can be sorted alphabetically or most recent first. You can also choose how many to show (all, 10, 15...). To change these settings hover over DIRECT MESSAGES then click the three dots to the right of it.

Replying to messages

It is possible to reply to messages posted in Channels or Direct Messages using 'threads'. These are helpful if you are having multiple conversations at once so people don't get confused about which messages are related to which discussion. To reply to a message in a thread click on the Reply icon:

Reply-to-message.png

Note: For a full explanation, watch the threading messages video (5 mins).

Reacting to messages

To add a reaction (e.g. a thumbs up or heart icon) to a message click on the Add Reaction icon:

Add-reaction.png

To post a reaction to a message, click on the Emoticon icon on the bottom right-hand side (17).

wbhemoticon-icon.png

Searching for messages (10)

Use the search box to find messages and replies that match the search terms entered. All Channels that you are a member of in the current Team are searched.

Note: For a full explanation, watch the Searching for messages video (3 mins).

Saving messages

You can click on the 'save' icon (like a bookmark) next to a message to save it for later, then bring up all your saved messages by clicking on the 'Saved posts' icon at the top right of the screen (12).

Note: For a full explanation, watch the Saving messages video (3 mins).

To add a picture, click on the paperclip icon on the bottom right of the screen (16). To add a nicely formatted link to your message, write the text you want to show in square brackets immediately followed by the link URL in round brackets. For example:

Check out this fantastic [guide to Mattermost](https://rebeltoolkit.extinctionrebellion.uk/link/394#bkmrk-page-title)!

will look like:

Check out this fantastic guide to Mattermost!

when sent.

Other formatting tips

Here are a few simple tips on formatting messages:

quote

Copying messages

It can be difficult to copy messages in order to share them in multiple Channels without losing the formatting and any links. Currently, the only way this is to:

  1. Open Settings (underneath 2)
  2. On the sidebar, click Advanced
  3. Set Enable Post Formatting to Off
  4. Copy and paste the messages that you want to share
  5. Return to Account Settings -> Advanced and set Enable Post Formatting back to On

Video Calls (8) 5JPBig-blue-button-icon.png

If you are in a Direct Message chat, clicking the 'Big Blue Button' will start a video call between you and the person (or people) in that chat; if you are in a Channel, it will open a video chat link for anyone in that Channel to join, using Big Blue Button. This posts a link for everyone to click on to join the call.

Rebel Compass (9)

Rebel Compass is a trusted guide through XR Global Support's digital services and infrastructure. Clicking this icon will take you to a resource page including plaforms, videos, documents, trainings, events, etc.

Notification settings

Note: For a walkthrough of all the content in this section, watch the Notifications (5 mins) and Acccount Settings (4 mins) videos.

So that you don't miss any important messages, it's strongly recommended that you adjust your notification settings. This will also make sure you aren't overwhelmed by huge numbers of irrelevant notifications.

To modify the notification settings in Mattermost, open Settings (underneath 2), which brings up the following:

GgvSettings-screenshot.png

Notification settings can be changed by clicking on the Notifications tab.

Setting desktop/mobile notifications

To modify these settings, go to the notification settings tab, as shown above, and click Edit in the sections labelled Desktop Notifications or Mobile Push Notifications.

We recommend that Send desktop notifications (under Desktop Notifications) and Send mobile push notifications (under Mobile Push Notifications) are set to either For all activity or For mentions and direct messages.

Enabling email notifications

You can enable email notifications of Mattermost messages. To do this:

  1. Open Settings
  2. In Email Notifications, click Edit
  3. Under Send email notifications, select Immediately
  4. Click Save

Setting notifications for reply threads

To be notified of all messages that happen in a thread you are participating in, you should:

  1. Open Settings
  2. In Reply notifications, click Edit
  3. Select Trigger notifications on messages in reply threads that I start or participate in
  4. Click Save

Personalising your mentions

It is possible to be notified every time a certain word is mentioned in one of your Channels. By default, this word will just be your username including the @ symbol (e.g. @myusername), but you can add extra words if you like. For example, if you do a lot of work on the Rebel Toolkit you may want to add toolkit to your list of words that trigger mentions. To set this up:

  1. Open Settings
  2. Next to Words That Trigger Mentions click Edit
  3. Tick any of the tickboxes that apply
  4. Add any additional keywords (e.g. toolkit) in the space below the tickboxes
  5. Click Save

Seeing recent mentions (11)

Click on the top right @ sign to see posts where you have been recently mentioned.

Grouping unread messages together

You can set Mattermost to collect unread messages at the top of the sidebar so they are easier to find. To do this:

  1. Open Settings
  2. Click on the Sidebar tab
  3. Click Edit in Group unread channels separately
  4. Select On
  5. Click Save

Setting up 'out-of-office' messages

If you will not be reachable on Mattermost for a while and would like to set an automatic reply to any messages received in that time, you should:

  1. Open Settings
  2. Under Automatic Direct Message Replies click Edit
  3. Select Enabled and write your message
  4. Click Save

You can follow the same process to disable the automatic messages when you return.

Getting rid of annoying messages from 'System'

In your Channels, you will probably see lots of messages from 'System' notifying that people have been added to and have left the Channel. You can turn these off by:

  1. Open Settings
  2. In the sidebar, Click Advanced
  3. Click Edit in Enable Join/Leave Messages
  4. Click Off and then Save

Further information

Setting your status

To change your status (which can be Online, Away, Do Not Disturb and Offline):

  1. Click on your icon at the top left of the screen (2)
  2. Select your preferred option

Adding a profile picture

To add a profile picture to your Mattermost account:

  1. Click on your icon (2)
  2. Click Profile
  3. Click Edit next to Profile Picture
  4. Upload an image of your choice
  5. Click Save

Logging out

To log out of Mattermost, click on your icon (2) and then click Log Out.

Other places to find information about Mattermost

There is a Help button (underneath 17) at the bottom right of the screen.

Here is useful list of other resources about Mattermost that you might find useful:

UK Forums

What are UK Forums?

UK Forums do slightly different things than MatterMost - here's a summary:

MatterMost is for:

Forums are for:

So, if the issue needs longer term attention, where contributions go towards making decisions, perhaps, or where differences of approach need closer examination, a Forum Topic can act as both a focus and catalyst for discussion. Also, you can look back throught the topic's contributions to see how a decision was made - this often helps to promote ideas and help towards reaching agreements.

Getting access

Important: You should have already completed the steps outlined on the READ THIS FIRST page before attempting to access UK Forums. Otherwise you will not have an account to log in to.

To access UK Forums you can:

You will then see a screen that looks like this:

UK-Forum_Log-In.jpg

The easiest option is to click the login 'with XR UK Hub' button. Or enter your username and password (same as for the Hub) and hit Log in.

Note: We recommend adding UK Forum to your browser's bookmarks/favourites so it's easier to find in future.

Our Forums are organised in much the same way as Mattermost, but the format is not quite the same. Here's what you'llsee when first you join UK Forums...

Basic Functions

Forums 'Landing Page'

When you get to the Forums 'Landing Page' you will find a complete list of the forums you're joined to by your Hub Group Membership. For ease of reference, your forums are classified into 8 Categories which reflect the different Regions/Nations and Working Groups (or Circles) that make up XR UK. Here's a typical Landing Page showing all 8 Categories:

Pams_Forum_Landing_Page_02_17Feb21.jpg

On the Landing Page, you'll find the forums from each of your Hub Groups as clickable link names in the different Categories. If there's a new post waiting for your attention, you'll see an 'unread' or 'new' button - click to go to the flagged post. There are several other functions, which are descibed in more detail below but first, let's see how you can make a reply ...

Reading and Replying to Posts

When you click on new or unread, you will be directed to the specific topic, where individual posts are listed in chronological order. If visiting the topic for the first time, you will see the initial post. If you've visited this topic before, you will see the post immediately after that visit. In the image, below, the "17/18" figures denote the 17th of 18 posts.