The Groups and Events addon allows you to:
- Create Groups to enable users to form and manage their own discussion groups. These Groups are designed to give a smaller subset of your community a (public or private) space to have discussions about a particular topic that doesn't necessarily fit in an existing Category.
- Create Events to showcase in your community Categories and Groups.
We'll examine each of these features in detail throughout this article.
Are Groups right for your community?
🛑 IMPORTANT: Inappropriate use of Groups can lead to discussion segregation, which may draw attention away from your main community Categories and hurt your community's cohesion and growth. Because of this, it's better suited for larger communities. We strongly recommend against using Groups if your community has fewer than several thousand currently active users (users that participate once a month or more).
If you're unsure whether Groups is right for your community, we recommend talking with your CSM.
Enable Groups and Events
- Access the Dashboard.
- Navigate to Settings > Addons > Addons.
- Click the Groups and Events toggle to turn it ON.
After enabling the addon, the Groups option will appear in your top-level navigation.
📝 NOTE: This may not be the case if you have a customized theme, and you’ll need to navigate directly to the URL /groups
from your Higher Logic Vanilla (Vanilla) community domain (e.g., yoursite.vanillaforums.com/groups
).
Groups overview
- Groups are designed to give a smaller subset of your community a self-contained public or private space to have discussions outside the existing Category structure (typically to discuss a more specialized or focused topic).
- A set of Group-specific permissions are included, allowing you to decide who can create and manage Groups (e.g., restricting group creation to only trusted members or moderators).
- Typical discussion features are available in Group posts, like the Rich Editor, Reactions, and comments.
- Groups include announcements, all discussions types (questions, polls, etc.), an events list, and leaders who manage the Group. You can control not only who can see the Group but also how users can join: freely, by application, or by invitation.
- All Administrators and Moderations with the permission
Garden > Moderation > Manage
can moderate Groups as well.
The Groups page
The main Groups page has three sections:
- My Groups: Lists the Groups you've created or joined.
- New Groups: Lists all recently created Groups.
- Popular Groups: Lists the Groups that have the most members, from newest to oldest.
Only a few Groups will show in each section; click their associated "see all" link to view all Groups in each section.
✔️ TIP: Keep an eye on this page over time to see what Groups are forming and growing the most.
Group permissions
If the Groups and Events addon is enabled, the GROUPS section is added to a Role's available permissions, with the following three permissions:
- Users with the
Groups > Group > Add
permission can create Groups.
✔️ TIP: We strongly recommend reserving the ability to create Groups to Administrators and (possibly) Moderators. This will prevent too many Groups from being created. It's better to have a small, curated list of Groups with active participation than to allow numerous Groups to cause participation to become too spread out. If you have 100 groups and only 3 are truly active, it will make your community look like a ghost town; on the other hand, if you have five groups and all five are healthy, your community will look vibrant and alive. Richard Millington at FeverBee.com has more great advice on restricting group creation.
- Reserve the
Groups > Moderation > Manage
permission to Administrators and Moderators, so only they can manage the Group's content. - The
Groups > Email Invitations > Add
permission enables users to invite others to join a Group.
Getting started with Groups
Try creating three to eight Groups as a pilot program to introduce the idea to your community. Generally speaking, it's better to have fewer total Groups to encourage higher quality and participation. For example, 10 Groups with 30 members each will create a far better experience than 100 Groups with three members each. Of course, the best number of Groups for your community depends on its size and specific needs.
Create a Group
1. On the Groups page, click New Group.
2. On the resulting page, configure the Group's details and settings.
- Give it an appropriate name.
- If you'd like to provide extra information or context for the Group, enter a description. This displays on the main Groups list and the Group's page.
- The Icon image shows on the Groups list.
- The Banner is the large image that displays at the top of the Group’s page. For most themes, 1000x175px is a good choice. We recommend testing this on staging prior to applying to production.
3. Select the Group's privacy setting:
- Public: All users can see the Group and its content. Anyone can join.
- Private: All users can see the Group, but only members can see its content. Users must apply or be invited to join.
- Secret: Only members can see the Group and its content. People must be invited to join. Secret Groups are completely hidden from non-group members. They are an especially good fit for product teams that want to test a new product or segment users to a special place, but do not want the larger community to know such a group exists.
4. When finished, click Save to create the Group.
Post Group content
On a Group's page, users with the appropriate permissions can post content, including announcements, discussions (of all types), and events. Each content type is displayed and managed in its own section of the page.
Announcements
This is where admins and the group leaders can make announcements, with a small preview of what the announcement is about. Just like in the community, a group discussion can be made into an announcement.
Discussions
Group discussions have all the features regular discussion do. Members of the Group, depending on the permissions you have set, can also ask questions or start a poll for the Group.
Events
Events can be created for the Group. Members can choose to attend via RSVP or they can decline or defer the invitation.
Manage Groups
From a Group's page (or the main Groups list), click the Options dropdown to access the following management options.
Edit Group
Edit any of the Group's details and settings, such as its icon or banner, or privacy setting.
Delete Group
Deleting a Group removes all of its associated content. This action is irreversible.
Invite Members
By default, Group owners, Leaders, and admins can invite users to join in two ways:
- Searching and selecting registered usernames.
- Invite users to groups via their email addresses.
Invites function differently depending on whether the recipient is a registered or unregistered user:
- Registered users will receive a notification letting them know they've been invited to the Group. The notification includes a link to the Group where they can accept or reject the invitation.
- Unregistered users will receive a notification letting them know they've been invited to the Group. The notification includes a link to your community's registration page where they can create their accounts before accepting or rejecting the Group invitation.
Manage Members
- This is where you view all of a Group's members, along with its assigned Leaders.
- You can search for members, which is useful for locating specific people in large Groups.
- In the Members area, you can click Leader to make someone a Leader or Remove to remove them from the Group.
- If a member is made a Leader, you can "demote" them back to a member at any time by clicking Make Member.
- For private and secret Groups, this is also where join requests are listed.
📝 NOTE: Leaders can manage the Group’s members and edit its settings, events, and discussions. The Group’s creator cannot have their Leader status removed. If you need the owner of a group reassigned, contact Vanilla Support.
Group membership notifications
Three notification options are available pertaining to Group membership:
- Group invitation: Receive notifications when you've been invited to join a Group.
- Group applicants: Group owners and Leaders can receive a notification when a user has applied to join their Groups.
- Group applicant approval: Users who have applied to join a Group can receive notifications when their group membership requests have been approved.
Set your notification preferences
You can set your notification preferences from your profile, on the Notification Preferences page.
The Social Groups Category
If the Groups and Events addon is enabled, the Social Groups Category is added. This is where users can go to see all Group discussion content they have permissions to view.
🛑 WARNING: Do not delete this Category - it's needed for the addon to work.
- By default, users should only have the
Social Groups > Comments > Add
and Social Groups > Discussions > Add
permissions for this infrastructure Category. - Administrators and Moderators should have ALL permissions except
view
.
You can update this by editing any Role:
Or, you can do the same thing for all roles in one view by updating the category:
For more information on this Category, or if you have accidentally deleted it, contact Vanilla Support.
Events
The Groups and Events addon provides the following Event functionality, allowing your organization to:
- Create Events in a Category or within a Group
- View Events in your Categories or within a Group
- RSVP to an Event
- Display upcoming Events in a widget that's located on the Recent Discussions and All Categories pages, as well as on individual Category pages.
Create Events
The main thing to understand when it comes to creating an Event is that it can be done either at the Category level or within a specific Group. This gives you the flexibility to make Events available to your larger community audience or limited to a Group's members.
Create community Events
You can create an Event in any community Category (including subcommunities).
- Users need the
Events > Manage
permission to add Events in Categories. You can set this for a Role in the Default Category Permissions to allow it for ALL Categories OR set this permission for a specific Category to limit the ability. - When you create an Event in a top-level category (like a subcommunity) the Event will be displayed in this subcommunity and all categories therein.
- When you create an Event in a sub-category, it will only appear in that sub-category.
✔️ TIP: You have the flexibility to have public Events or private Events by leveraging Category permissions.
To create an Event:
- From the desired Category, click New Post > New Event.
- Refer to the Event options section below to learn more about each configuration option.
Create Group Events
- On a Group's page, click the New Event button in the Upcoming Events section.
- Refer to the Event options section below to learn more about each configuration option.
Event options
Regardless of where an Event is created, the configuration options are the same:
- Name of the Event: Give the Event an appropriate name.
- Event Details: This is where you can provide any relevant event details to your intended audience.
- Where: Explain where the event is being held, whether it's a virtual space (e.g., Zoom) or an in-person venue.
- Event URL: For virtual events, this is typically the URL necessary to access the event; otherwise, this may be a web page with more details about the event.
- From/To: This is how you select the event's date and time.
View Events
Depending on whether an Event was created at the Category or Group level determines where you'll go to view it.
View community Events
- Events associated to a community Category respect that Category's permissions.
- Users need the
Events > View
permission to view and RSVP to Events in Categories. You can set this for a Role in the Default Category Permissions to allow it for ALL Categories OR set this permission for a specific Category to limit the ability.
Category Events are displayed in the Upcoming Widgets widget, which is available on the Recent Discussion page, the All Categories page, and on individual Category pages.
- Click an Event to view its full details on a dedicated page.
- Click More Events to access the main Events page for a full list of upcoming events.
View Group Events
As you'd expect, you can view a particular Group's Events on its page, in the Upcoming Events section.
- Click an Event to view its full details on a dedicated page.
- Click All Events to access the main Events page for a full list of upcoming events.
Event details page
Clicking an Event takes you to its dedicated page with the Event's full details. From there, you can learn more about the Event and click Going, Maybe, Not going to indicate whether you plan to attend or not.
Manage Events
- Users need the
Events > Manage
permission to edit and delete Events at Category level. - Event Leaders, authors, and Administrators (and potentially Moderators) can edit Events at the Group level.
Additional resources
Click the link below to access a video expanding on what you learned in this article.