Discourse 2.1 released!

Jeff Atwood September 10, 2018

Today we release Discourse 2.1, building on Discourse 2.0 from May.

We’ve chosen a new set of codenames for releases starting with 2.1 that are based on the history of human communication. This release is Bhimbetka, and the next two will be La Pasiega and Vinca.

Access to Drafts

Once you’ve written a bit of text in a post, Discourse begins to periodically save automatic drafts as you continue to type. That way you never lose anything you’ve written if the power suddenly goes out, or you get dodgy WiFi in the middle of writing a long reply. But it was an automatic and sort of hidden feature — though a magical lifesaver when you needed it! We’ve finally added a drafts tab on your profile to see all your in progress reply drafts, satisfying a very long running power user request.

Linked account control

You can now easily see, add, and revoke any available social logins directly from your account page. This is a combination convenience and security feature. Bear in mind that you can always log in as “you” with any social login, provided the site owner has configured it, and those credentials map to the same exact verified email address.

Automatic Trust Level Promotion PM

Communities need a regular influx of new users not just for fresh perspectives but also for long term sustainability. Users that sign up and stick around to read deserve a bit of extra encouragement! So we’ve added a friendly little automatic PM just-in-time nudge that goes out to those new users who’ve already started down the path toward becoming engaged community members.

Discourse Automatic Trust Level Promotion PM

Printed Backup Two Factor Authentication Codes

We added two factor authentication in Discourse 2.0, but if you lost your phone you were in a bit of a pickle as you’d need to contact an admin to turn off 2FA for your account. In this release we’ve added the ability to print backup codes, so you can smoothly recover from any 2FA issues all on your own — provided you saved those backup codes, of course!

Discourse Two Factor Auth Backup Codes

Improved PM Participants UI

We’ve cleaned up the PM interface to more clearly show which people are on the PM, and how to add or remove PM participants. Remember, you can always remove yourself from any PM you don’t wish to be on, of course!

Discourse PM participants UI

Reply Without Bumping and Category Auto-Bumping

One request that historically came up a lot is the ability to post to a topic without bumping it — that is, add a new reply that does not cause the topic to show up in the list of topics that have recent replies, as it normally would. Now you can! Just select the “toggle topic bump” option when replying.

Discourse reply without bumping the topic

Speaking of bumps, we added a category preference to automatically bump a certain number of open topics every so often in a category. This is great for to-do or support style categories, where open topics mean something isn’t yet handled, and needs a bit more attention.

Multiple color schemes

We’ve offered the default “dark” and “light” themes for quite some time. In conjunction with our color scheme contest, we’ve added a variety of different color schemes to choose from. Launch the setup wizard any time and pick from 6 delightful new color schemes, in addition to our classic dark and light options.

And More!

These are just the highlights of 2.1 — we didn’t even mention Emoji 11 support, auto-expiring API keys for enhanced security, a big increase in performance for rare megatopics, or a significant reduction in the size of a key email log table. See the full release notes for complete details.

Easy One Click Upgrade

If you are on our hosting, you’re already upgraded. Otherwise, upgrading is as easy as clicking the Update button linked from your Discourse dashboard.

Discourse Admin Dashboard, version upgrade notice

We have a public exploit bounty program at Hacker One as a part of our security policy. We strive mightily to be secure by default, and we rapidly follow up on any security concerns. There are several important security fixes in 2.1, so we urge everyone to upgrade to it as soon as possible.

If you don’t have a Discourse to upgrade, why not? Install it yourself in under 30 minutes, or get a free 14 day hosting trial!

Thank You

As always, we must first thank our customers for their direct financial support, without which there would be no Discourse project at all.

Open source projects are only truly alive when they receive regular outside code contributions. Thanks for the pull request contributions in this release from:

David Lee
Nick Shearer

We had a remarkable number of translators who contributed their time and effort translating Discourse into dozens of languages for this release. It’s because of you that so many people around the world can benefit from great free, open source discussion software, and we appreciate your hard work.

Thanks to the greater Discourse community for posting support / bug request / feedback topics on meta.discourse — your feedback makes Discourse better, not only for your community, but all of us together.

Check out the releases category to see what’s coming up on our roadmap for Discourse 2.2, 2.3, and beyond!


Launching a Successful Discourse Community

Jeff Atwood August 6, 2018

While we’ve offered general tips for building a Discourse community, we also get a lot of questions about what specifically you can do to help launch a successful Discourse community.

What is the “elevator pitch” for your community?

The very first thing people will ask — what is this place? How would you describe your community to someone you just met in a 60 second elevator ride? Make sure that’s visible on your home page, as a banner or pinned topic.

Build some interesting discussions to launch with

group of people working

  • What comes up often in your internal emails? Are there common themes that tend to come up again and again with your fans, customers, users, patrons, teammates, coworkers, subscribers? Try moving those discussions out of private email silos into your public (or private) discussion area.

  • If you find an interesting article on the web you want to discuss, quickly start a new topic by pasting a link into the topic title. Try it!

  • Have some open-ended getting to know you topics for people to share their opinions, experiences, stories, or pictures. An “introduce yourself” topic is always fun, and you should go first!

  • Where have you seen interesting, thoughtful discussions recently? Can you bring the spirit of those discussions to your site? Imagine what a model user you would love to see on your site would do – and then try doing that yourself. Invite friends or coworkers to post example topics and reply to them so visitors can browse the existing conversations to discover what your community is about.

Get the right people in the room

social media notifications

  • Send personal invitations to your staff, power users, or friends, to log in early and reply to your initial topics to generate activity. Send one-click email invites via your Discourse invite page (it’s on your user profile page). You can also send bulk invites to many email addresses at once.

  • Generously like any and every post you enjoy! What type of content gets liked is a major part of your community’s culture. Set an example by frequently liking posts in the early days of your forum. Seeing liked posts also encourages people to reciprocate in kind, and come back for more.

  • Actively seek the help of power users and early adopters in your community. There’s a built in feedback category titled “site feedback” for discussing organization and governance. Let your most avid users have a say in what your community does, how the site works, and what your community becomes.

How do people find your community?

navigation diagram and arrows

  • Where can you place links to your community so that people (and web search engines) will naturally discover it? In the header or footer of your website? Where else?

  • Promote your community. Add a note to your mailing lists or email newsletters, put up a notice on your website, or make a blog entry about your new community. Consider running a contest of some kind.

  • What rewards, perks, contests, or incentives can you give people for signing up, for posting, for replying? Check your user directory at /users to see engagement statistics, and shower your best users with attention to encourage them.

For additional advice, see our blog post on how to build engaging Discourse communities.

Good luck! And don’t forget the most important ingredient of all — time. Building a community takes patience and persistence. Plan to stick around for weeks, months, even years!


Understanding Discourse Trust Levels

Jeff Atwood June 25, 2018

The user trust system is a fundamental cornerstone of Discourse. Trust levels are a way of…

  • Sandboxing new users in your community so that they cannot accidentally hurt themselves, or other users while they are learning what to do.
  • Granting experienced users more rights over time, so that they can help everyone maintain and moderate the community they generously contribute so much of their time to.

As documented in Community Building on the Web, there is a natural progression for participants in any community.

This seemed like a great starting point for our user trust system. Thus, Discourse offers five user trust levels. Your current trust level is visible on your user page, and a summary of all trust levels within your community is presented on your dashboard.

Discourse trust level counts

Trust Level 0 — New

By default, all new users start out at trust level 0, meaning trust has yet to be earned. These are visitors who just created an account, and are still learning the community norms and the way your community works. New users’ abilities are restricted for safety – both theirs and yours.

(We also want to hide any “advanced” functionality from new users to make the UI less confusing for them as they gain more experience.)

Users at trust level 0 cannot

  • Send personal messages to other users
  • “Reply as new topic” via Link button (UI removed)
  • Flag posts
  • Post more than 1 image
  • Post any attachments
  • Post more than 2 hyperlinks in a post
  • Have actual links in the ‘about me’ field of their profile (will be silently and temporarily converted to plain text)
  • Mention more than 2 users in a post
  • Post more than 3 topics
  • Post more than 10 replies

Admins can change these limitations by searching for newuser and first_day in site settings.

Trust Level 1 — Basic

At Discourse, we believe reading is the most fundamental and healthy action in any community. If a new user is willing to spend a little time reading, they will quickly be promoted to the first trust level.

Get to trust level 1 by…

  • entering at least 5 topics
  • reading at least 30 posts
  • spend a total of 10 minutes reading posts

Users at trust level 1 can…

  • use all core Discourse functions; all new user restrictions are removed
  • Send PMs
  • Upload images and attachments if enabled
  • Edit wiki posts
  • Flag posts

Admins can change these thresholds by searching for tl1 in site settings.

Trust Level 2 — Member

Members keep coming back to your community over a series of weeks; they have not only read, but actively participated long and consistently enough to be trusted with full citizenship.

Get to trust level 2 by…

  • visiting at least 15 days, not sequentially
  • casting at least 1 like
  • receiving at least 1 like
  • replying to at least 3 different topics
  • entering at least 20 topics
  • reading at least 100 posts
  • spend a total of 60 minutes reading posts

Users at trust level 2 can…

  • Use the “Invite others to this topic” button for one-click onboarding of new users to participate in topics
  • Invite outside users to PMs making a group PM
  • Daily like limit increased by 1.5×

Admins can change these thresholds by searching for tl2 in site settings.

Trust Level 3 — Regular

Regulars are the backbone of your community, the most active readers and reliable contributors over a period of months, even years. Because they’re always around, they can be further trusted to help tidy up and organize the community.

To get to trust level 3, in the last 100 days…

  • must have visited at least 50% of days
  • must have replied to at least 10 different topics
  • of topics created in the last 100 days, must have viewed 25% (capped at 500)
  • of posts created in the last 100 days, must have read 25% (capped at 20k)
  • must have received 20 likes, and given 30 likes.*
  • must not have received more than 5 spam or offensive flags (with unique posts and unique users for each, confirmed by a moderator)
  • must not have been suspended

* These likes must be across a minimum number of different users (1/5 the number), across a minimum number of different days (1/4 the number). Likes cannot be from PMs.

All of the above criteria must be true to achieve trust level 3. Furthermore, unlike other trust levels, you can lose trust level 3 status. If you dip below these requirements in the last 100 days, you will be demoted back to Member. However, in order to avoid constant promotion/demotion situations, there is a 2-week grace period immediately after gaining Trust Level 3 during which you will not be demoted.

Users at trust level 3 can…

  • recategorize and rename topics
  • access a secure category only visible to users at trust level 3 and higher
  • have all their links followed (we remove automatic nofollow)
  • TL3 spam flags cast on TL0 user posts immediately hide the post
  • TL3 flags cast on TL0 user posts in sufficient diversity will auto-silence the user and hide all their posts
  • make their own posts wiki (that is, editable by any TL1+ users)
  • Daily like limit increased by 2×

Admins can change these thresholds by searching for TL3 in site settings.

Trust Level 4 — Leader

Leaders are regulars who have been around forever and seen everything. They set a positive example for the community through their actions and their posts. If you need advice, these are the folks you turn to first, and they’ve earned the highest level of community trust, such that they are almost moderators within the community already.

Get to trust level 4 by…

  • Manual promotion by staff only
  • (Possibly via a to-be-developed election system in the future)

Users at trust level 4 can…

  • edit all posts
  • pin/unpin topic
  • close topics
  • archive topics
  • make topics unlisted
  • Split and merge topics
  • Daily like limit increased by 3×

We believe this trust system has been a success so far, as it leads to stronger, more sustainable communities by carefully empowering members, regulars, and leaders to curate and lead their own communities. But like everything else in Discourse, the trust system is evolving over time as we gain more experience with more communities. We’ll continue to update this post with any changes.


For more blog posts, visit the archives