# Configuring how users can create and send invites for others to join your community

**URL:** https://meta.discourse.org/t/configuring-how-users-can-create-and-send-invites-for-others-to-join-your-community/124096
**Category:** Site Management
**Tags:** how-to, invites, users
**Created:** [26 juli 2019 om 20:52 UTC](https://meta.discourse.org/t/configuring-how-users-can-create-and-send-invites-for-others-to-join-your-community/124096 "2019-07-26T20:52:07Z")
**Posts on this page:** 1
**Page:** 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: [26 juli 2019 om 20:52 UTC](https://meta.discourse.org/t/configuring-how-users-can-create-and-send-invites-for-others-to-join-your-community/124096/1 "2019-07-26T20:52:07Z")

</div>

> 🔖 This guide explains how to configure, create, and manage user invitations in Discourse.
> 
> 🙋 Required user level: Administrator

Discourse allows users in permitted groups to invite new members to your community (default trust level 2). Invites can be configured to redirect the new user to a specific topic when they first join the site. Invites can also be configured to add the user to custom Discourse groups when they accept the invite.

## Configuring invite-related site settings

The following site settings can be adjusted to configure how invites work on your site:

| Name | Description |
| --- | --- |
| `invite allowed groups` | The groups that are allowed to invite new users to the site (defaults to trust level 2 and staff) |
| `default invitee trust level` | The trust level that will be granted to invited users (defaults to trust level 1) |
| `max invites per day` | The maximum number of invites that a regular user can send in a day. This limit is not imposed on staff members. (Defaults to 10 invites per day) |
| `invite expiry days` | The number of days that an invitation is valid for (defaults to 90 days) |
| `invite link max redemptions limit` | The maximum number of redemptions that an invite link created by a _staff_ user can have (defaults to 5000) |
| `invite link max redemptions limit users` | The maximum number of redemptions that an invite link created by a non-staff user can have (defaults to 10) |

## Creating an invite

To create an invite, access the “invites” section from your user’s profile page. That will take you to your pending invites page. That page shows a list of previous invites you have sent and allows you to send new invites. Click the “Invite” button to start creating a new invite:

 ![invite page](https://global.discourse-cdn.com/meta/original/4X/9/9/2/992c7c33a1f42fd886d1fee68967dcb49339f544.png)

A modal window will open that allows you to configure the invitation:

 ![create invite](https://global.discourse-cdn.com/meta/original/4X/b/1/4/b141b6de58c636e7083a493a2ae6e3f1fcbaa924.png)

- **Description** : Add an optional description to the invite for easier organization.
- **Restrict to** : Enter an email address or domain (e.g. `example.com`) to limit who can use the invite.
- **Max uses** : Set the number of allowed redemptions if not limiting to one email in the previous field.
- **Expire after** : Set the time period the invite will be valid for.
- **Arrive at topic** : Choose a topic for users to land on after joining. _(Staff only, hidden when `must approve users` is enabled)_
- **Add to groups** : Select groups the new user will be added to. _(Staff and group owners only)_
- **Custom message** : Add a personal note to your invitation email. _(Only shown when restricting to an email address)_

After configuring the invite, if you have restricted it to an email address, you will be given the option to either copy the invite link, or to send an invite email directly from your Discourse site:

 ![invite by email or save link](https://global.discourse-cdn.com/meta/original/4X/1/4/e/14eeba4da39452f81c2bc3e747df9af088fb25c0.png)

If you have not restricted the invite to an email address, you will just be given the option to copy the invite link.

## Alternative methods of inviting users

### Inviting to a specific topic

Users can be invited to a specific topic by clicking the “Share” button from the topic’s footer. Click the “Invite” button in the modal that opens to access the invite form. Note that only admin users on the site can invite a user to a topic that’s in a protected category. When doing that they will be prompted to add the user to the group that has access to the category.

 ![invite from Share](https://global.discourse-cdn.com/meta/original/3X/d/c/dc4905bb3d23ddedaeb6aac51c5017f234ea363b.png)

### Inviting to a group

Group owners and site admins can invite new users to a group from the group’s page. Click the Invite button from the group’s page to open the invite modal:

 ![invite from Groups page](https://global.discourse-cdn.com/meta/original/4X/3/5/c/35cc200cdcbd2c15af23e52c7e47de642c71ba05.png)

## Accepting an invite

When an invite is accepted by visiting an invite link, the user will be taken to a page that displays the same fields as are seen on your site’s signup modal. An exception to this is that if the invite was created for a specific email address, the email field will not be displayed. Instead, an account will be created for them with the email address that the invite was configured for:

 ![accept invite](https://global.discourse-cdn.com/meta/original/3X/c/3/c37333ee8d1b658a3a069c4037b7bf7103b743b1.png)

## Invite Analytics

Statistics about how many people have signed up from a specific link can be viewed on the “Invites” page of the user who created the invite link or invite email.

In particular, the “Pending” page will display a list of all invite links that are currently active, and will show a count of how many users have redeemed the link out of how many total sign ups are allowed from the link. The “Expired” page will show a similar view, but will only display invitations that are no longer active, and you can also view a list of all users who have redeemed invite links on the “Redeemed” page.

 ![pending invites](https://global.discourse-cdn.com/meta/original/4X/2/7/c/27c2f68a08516f512b9a611efd5bf66c618ade7f.png)

Additionally, the [Data Explorer](https://meta.discourse.org/t/discourse-data-explorer/32566)plugin can be used to create a reports about invite statistics using the `invited_users` table. For example, the following SQL query will display a list of all users who have been invited to a site, along with who invited them, and how long ago the user signed up:

> **Invited Users List**
>
> ```sql
> SELECT iu.user_id, 
> i.invited_by_id AS invited_by_user_id, 
> iu.redeemed_at AS reltime$time 
> FROM invited_users iu
> JOIN invites i ON iu.invite_id = i.id
> WHERE iu.redeemed_at IS NOT NULL
> ORDER BY iu.redeemed_at DESC
> 
> ```

## Common issues and solutions

- **Invite not working** : Check invite expiry and redemption limits.
- **Users not receiving invites** : Verify the [sent email logs](https://meta.discourse.org/t/troubleshooting-outgoing-email/271484#sent-email-logs-1) and email address validity.

## Additional resources

- [How to customize specific email templates](https://meta.discourse.org/t/how-to-customize-email-templates/88323) (gives details about customizing the invite emails)
- [Sending Bulk User Invites](https://meta.discourse.org/t/sending-bulk-user-invites/16468) (send bulk invites from a CSV file)
- [Automate sending Discourse invite emails with Zapier](https://meta.discourse.org/t/automate-sending-discourse-invite-emails-with-zapier/121608)
- [List of users who signed up via invitations](https://meta.discourse.org/t/list-of-users-who-signed-up-via-invitations/224871)

> Last edited by @pedro 2025-07-23T20:13:10Z
> 
> Last checked by @hugh 2024-07-03T05:03:55Z
> 
> > **Check document**
> >
> > Perform check on document: