Sending Bulk User Invites

:mega: For a simpler way to invite many users to your Discourse instance with a shared link, see Multiple Use Invite Links. This feature, added in version 2.5, allows for bulk sending invites with a single invite link and optionally adding users to a specific group.

:warning: if you have SSO enabled, or have disabled local logins, invites cannot be sent as they would bypass parent site authentication. Invites only work if SSO is not enabled and local logins are enabled.

So you want to invite users to your Discourse instance, but you have so many that sending invites individually would be a lot of work? Good news – you can send bulk invites! Here’s how:

Prepare CSV File

Prepare a CSV file with the users you want to invite. These points should be considered while preparing CSV file:

  • One user per line.
  • Email is required in the first column, and the email must be valid.
  • Any permissions groups you want this user to be a member of should be in second column. For multiple groups, separate group names with a semicolon group_1;group_2;group_3
  • Normally invited users arrive at the homepage. If you would rather invited users end up on a specific topic, enter that Topic ID in the third column.

The format is:,group_1;group_2,topic_id

Note that group names and topic id are completely optional, only email is mandatory. You can have an invite that is just the email alone:

It’s easy to create CSV files in a spreadsheet, which would look like this:

Just be sure to save the file as CSV when you’re done.

Upload CSV File

Go to Invites page and upload the CSV file by clicking Bulk Invite from File button.

You will see a confirmation modal show up asking for approval to send messages to these users. Click Go Ahead to proceed inviting.

Afterward, you’ll receive a confirmation stating you’ll be notified when the process is complete.

Bulk Invite Progress Notification

Once the CSV file is processed, you will receive a private message notification with a progress report.

The notification will summarize what happened with your bulk invites, including total counts of invites sent and not sent. Check your invites page on your user profile to see a list of the invites that were successfuly sent.

If there were errors reported, you can submit a new bulk invite file with corrected lines.

Invites Sent

Each email address will receive an invite email:

{username} invited you to join

{Community Title}

A brief description of this community taken from the site description setting.

If you’re interested, click the link below:

If you wish to customize the above text:

  • When you invite people to join, they get sent the Invite Forum Mailer email template.

  • When you invite people to join and include a specific topic_id, they get sent the Invite Mailer email template.

Once clicking the confirmation link:

  • their account will be immediately activated and associated with this email address
  • they will be added to the specified groups (if specified)
  • they will be directed to the target topic ID (if specified)

If the invites are never clicked, they will expire naturally after 30 days.


A note for the documentation:

When you invite people to join and include a specific topic_id, they’re sent an email that can be customized using the Invite Mailer template

If you invite them to join the forum without a specific topic, they get sent the Invite Forum Mailer