As a new user Peyups user (or old returning user
✌🏼), the new site can be rather intimidating and maybe unintuitive (if you’re used to older forums). Hopefully this guide will make things just a little bit easier
Basic Terms Used by Discourse
Here are some basic terms that will be helpful to keep in mind as you use the forum or read this guide:
Topic The collection of messages grouped together in a meaningful conversation, with a title, listed in a category, beginning with an Original Post, and including all replies in chronological order.
You may know this a thread in other forums.Discourse uses ‘topic’ since thread is used for linked elements that can go off in many different directions (and be confused with programming terms).
Post Each element of a topic is referred to as a post. Each post has its own author and can be moved to a different topic if necessary, or even become the start of a new topic.
Original Post (or OP) The first post in any topic. This is key since it determines the focus of the topic and is what the title will link to.
Category The primary means of organizing topics. Each topic is placed in exactly one category. Categories have permissions which can restrict which users can create, reply, and see its topics. You can also configure notification preferences per category or even mute them as explained below.
User Discourse sites may be private or public for anyone to read, but you will always be required to register in order to create posts and record any actions such as bookmarking, liking, tagging, and flagging. Most site activity, therefore, is based around registered Users
Browsing the Forum
By default, the Discourse homepage will show the Categories along with the Latest conversations in the community but you can filter this list in a number of ways:
- By category: in the menu line, click the ‘all categories’ title and a list of all the categories appears.
- By level of activity: if you click on ‘Top’ the conversation topics will be listed in order of most activity (views and replies) for a specific time period. You can choose whether this is for all time, or select a specific period such as quarter, month, week or just today.
By what’s ‘New’ to you: by default, new topics are those created in the last 2 days that you have not opened yet to keep the list fresh and relevant. New topics show a small dot next to the topic title
By what topics are “Unread”: by default, unread topics are those that you have previously opened and read for at least 4 minutes, and that have new posts (replies) submitted to them. Unread topics show a number in a circle indicating how many new posts are in the topic.
See who is participating
There are several ways to see who is involved in topics.
On the homepage you will see a selection of avatars (profile pictures) of:
- the user who started the topic (always the first photo);
- a selection of the most active participants;
- and, who created the most recent post (usually the last photo).
- in some cases, the first photo has a colored border or halo to indicate that the original poster is also the most recent poster
The box at the bottom of the OP tells you:
- who created the post and when
- a count of the replies and views in this topic to date
- avatars of the most frequent participants
- approximately how long it will take to read the entire topic.
For Search, the Menu, or your User page, use the icon buttons at the upper right.
Content is king but it’s not everything. Readers are also an important part of the community. What’s the point of posts that no-one reads? Discourse encourages and tracks reading habits so community managers can keep a healthy balance.
Click a topic title and read down the list of replies in chronological order, following links or previewing replies and quotes as you go. Use your mouse to scroll the screen, or use the timeline scroll bar on the right which also shows you how far through the conversation you’ve read. On smaller screens, select the bottom progress bar to expand it.
Jump back in
- Selecting a topic title will take you to your last read post in the topic. To enter at the top ↑ or bottom ↓ instead, click the reply count or last reply date.
- Topics above the light red line on a list are new or updated since your last visit. If you have read all the way to the end of a topic, the title will be light grey instead of black.
Sometimes conversations are clearer if topics are split, where posts are moved to a more appropriate topic, or two related topics are merged. If a post is moved, a link will appear that will allow readers to jump to that comment wherever it has been moved to, and the person who posted it will also be notified.
At the end of the OP you will also see a list of links posted in the topic
Taking Part in Conversations
Press any Reply button to open the editor panel at the bottom of your browser. You can continue reading (and even search or navigate to different topics) while you compose your reply.
Posts are shown in the order they are published. There is no threaded view. However, it still gives you lots of ways to follow the context of conversations.
To reply to a specific post in a topic, clicking the grey Reply button at the end of each post links your reply to that post.
- If your reply is the next one published after the post you are replying to, this will appear next in chronological order
- If yours is NOT next, then two things happen after your post is published:
- Your post will include a new link in its header with an image to show what this is ‘in reply to’ - clicking this link displays that previous post for context next to your reply
- The original post includes a count of replies at the bottom - clicking this link displays the content of the replies
Drafts will automatically be saved as you write. If you minimise the editor or navigate to a different topic, the editor might disappear. To open a draft, return to the topic you were replying to or click the highlighted bar at the bottom of your browser, and the editor will reappear with your draft.
To insert a quote, select the text you wish to quote, then press the Quote button that pops up. There is no need to quote the a whole message, it helps to be specific. Repeat this for multiple quotes even from different posts and different users. The quoted text will point to their original source.
To notify someone about your reply, mention their name. Type
@ to begin selecting a username. This search will also search the name fields in case you don’t know a particular username.
To use standard Emoji, just type
: to match by name, or traditional smileys
Alternatively, click on
more to see a complete list of emoji to select from. Or you can use your operating system’s emoji support
Link previews and media embeddings
To generate a summary for a link, paste it on a line by itself. To start a topic with a link, paste the link into the title field.
This also works for Youtube and other media sites.
You can test these in our testing area.
Your reply can be formatted using simple HTML, BBCode, or Markdown:
This is <b>bold</b>. This is [b]bold[/b]. This is **bold**.
For more formatting tips, you can check our formatting guide.
Actions and Reactions
There are action buttons at the bottom of each post:
- To let someone know that you enjoyed and appreciated their post, use the like button. Share the love!
- Grab a copy-pasteable (permalink) link to any reply or topic via the link button.
- Use the … button to reveal more actions. Flag to privately let the author, or the site staff, know about a problem. Bookmark to find this post later on your profile page.
When someone is talking directly to you — by replying to you, quoting your post, mentioning your
@username , or even linking to your post, a gray number will immediately appear over your profile picture at the top right.
When you have been sent a Personal Message you will receive this in your Inbox and a green number will appear over your profile picture to the left.
Click your profile image to scroll through all your notifications.
You can optionally receive all these notifications as push notifications to your desktop browser or mobile Android device (iOS folks, let me know it’s available for you, too. I don’t have an iPhone to test things on ). Simply allow the site to send you notifications through your browser when it asks permission.
If you want, you can get notified about other things happening on the site as well, either at the category or topic level.
You can change your notification level for any individual topic via the notification control at the bottom, and right hand side, of each topic.
Notification level can also be set per category. To change any of these defaults, see your user preferences, or visit the category page, and use the notification control above the topic list, on the right side.
Feedback and next steps
You should have enough knowledge to confidently go around and participate (or maybe just lurk) in the forums. Should you want to do everything you’ve learned here but faster, you might want to learn yourself some keyboard no jutsu.
This guide is a snapshot of current state of peyups and Discourse as of this writing (2020-05-16T12:29:00Z). If you find something that doesn’t work, don’t hesitate to post a response. If you think I missed anything, do post a response as well. This guide is a localization of the new user guide at the OG Discourse forum.
If you read this far then thank you and I hope you found this useful. Post away and see you around