# Discourse Follow

**URL:** https://meta.discourse.org/t/discourse-follow/110579
**Category:** Plugin
**Tags:** official, follow
**Created:** [March 3, 2019, 10:36pm UTC](https://meta.discourse.org/t/discourse-follow/110579 "2019-03-03T22:36:50Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [March 3, 2019, 10:36pm UTC](https://meta.discourse.org/t/discourse-follow/110579/1 "2019-03-03T22:36:50Z")

</div>

**IMPORTANT WARNING: This plugin may affect whether laws that regulate social media apply to your forum. Consult legal for advice.**

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Discourse Follow** allows users to follow other users, list the latest topics involving them, and receive notifications when they post. |
| 🛠 | **Repository Link** | [https://github.com/discourse/discourse-follow](https://github.com/discourse/discourse-follow) |
| 📖 | **Install Guide** | [How to install plugins in Discourse](https://meta.discourse.org/t/install-plugins-in-discourse/19157) |

> [@](#):
>
> :discourse2: As this is an #official plugin maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started. 👍
> 
> [❓&nbsp; **Support**](https://meta.discourse.org/new-topic?category_id=6&body=%3E%20Before%20asking,%20did%20you%20search%20first%3F%20Press%20%F0%9F%94%8D%20at%20the%20upper%20right%20to%20search.&tags=follow "Ask for support on configuring and using Discourse Follow") [🐛&nbsp; **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=follow "A bug report means something is broken, preventing normal/typical use of the plugin") [👀&nbsp; **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=follow "Discussion about the user interface of Discourse Follow, and how features are presented (including language and UI elements)") [💡&nbsp; **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=follow "Discussion about how existing Discourse Follow features can be improved or enhanced, and how proposed new features could work")

### Screenshots

Followed users posts feed:

 ![follow-feed](https://global.discourse-cdn.com/meta/original/3X/5/c/5cf0ac18db2687a880570a57008e18ba2360eed5.png)

List of users you’re following:

 ![following-list](https://global.discourse-cdn.com/meta/original/3X/f/f/ff50b23cc7f554df4153c5061cf90275b40e5ca4.png)

Follow button on the user card and profile page:

 ![follow-user-card](https://global.discourse-cdn.com/meta/original/3X/0/d/0dc49380c141c81a120e14296725c68f92bf1aa0.png)

 ![follow-profile-page](https://global.discourse-cdn.com/meta/original/3X/c/d/cdda72a8bf0bf7cabd09162da35568302ae04f5b.png)

User preferences:

 ![follow-preferences](https://global.discourse-cdn.com/meta/original/3X/2/f/2f352a2479ebe6e7e7cef9644a681d1e686ef070.png)

Admin site settings:

 ![follow-plugin-site-settings](https://global.discourse-cdn.com/meta/original/3X/7/5/751adf3565fb413d818f3b866a64526cf2fd53a6.png)

### Configuration

#### User preferences

| Preference | Purpose |
| --- | --- |
| `Notify me when followed` | Enables/disables notification when someone follows you |
| `Notify followed user when followed` | Enables/disables notifications that other people receive when you follow them |
| `Notify me when followed replies` | Enables/disables notifications when people you’re following reply |
| `Notify me when followed creates topic` | Enables/disables notifications when people you’re following create new topics |
| `Allow people to follow me` | Allow/don’t allow anyone to follow you. If you turn this preference off and you have existing followers, they’ll no longer receive notifications about your new replies/topics, you will not appear in their following users list, and your posts will not appear in their follow feed. |

#### Changing defaults of user preferences

Each user preference that the plugin adds has a site setting counterpart that controls the default value of the preference for future users and users who have never changed any of the preferences added by the plugin.

For example, the `default notify me when followed creates topic` site setting controls the default value of the `Notify me when someone I follow creates a topic` preference. If you change that site setting, then all new signups will have that preference set to the same value as the site setting. Existing users who never changed any preferences added by the plugin will also be affected by the site setting change.

#### Site settings

| Setting | Default | Purpose |
| --- | --- | --- |
| `discourse follow enabled` | True | Enables/disables the plugin |
| `follow show statistics on profile` | True | Controls whether the “Followers” and “Following” counts are shown on the user card and profile (see screenshots above) |
| `follow notifications enabled` | True | Enables/disables all kinds of notifications added by the plugin (when disabled it overrides user preferences) |
| `follow followers visible` | Everyone | Controls who can see the followers list under user profile and the Followers count |
| `follow following visible` | Everyone | Controls who can see the following users list under user profile and the Following count |
| `default notify me when followed` | True | _(see the sections related to user preferences above)_ |
| `default notify followed user when followed` | True | _(see the sections related to user preferences above)_ |
| `default notify me when followed replies` | False | _(see the sections related to user preferences above)_ |
| `default notify me when followed creates topic` | False | _(see the sections related to user preferences above)_ |
| `default allow people to follow me` | True | _(see the sections related to user preferences above)_ |

### Credits

This plugin was developed by the Pavilion team and maintained by them until October 2021 when it was promoted to an #official plugin. The Discourse team (CDCK, Inc) is currently maintaining this plugin.

> :discourse2: **Hosted by us?** This plugin is available on our Enterprise plans

> Last edited by @JammyDodger 2024-06-18T15:17:12Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/discourse-follow/110579)._
