Gebruikers toevoegen aan groepen via automatisering van aangepaste velden

[Discourse]

This guide explains how to automatically add users to groups based on their selection of a custom user field during signup or profile update.

Required user level: Administrator

Summary

1. Create the necessary groups
2. Set up a custom user field
3. Create an automation to add users to groups
4. Test the setup

Creating the groups

First, create the groups you want users to be automatically added to:

1. Go to your site’s Admin area
2. Navigate to Groups in the admin sidebar, or visit /admin/groups
3. Click “New Group” for each group you want to create
4. Make sure to add a “Full Name” for each group, as the automation script uses this
   
   

The automation script matches the user’s custom field value against a group’s Full Name. Make sure each group’s Full Name exactly matches the corresponding custom field option (e.g., if the dropdown option is “cat”, the group’s Full Name must be “cat”).

Setting up the custom user field

Next, create a custom user field that users will select from:

1. Go to your site’s Admin area
2. Navigate to User Fields in the Community section of the admin sidebar, or visit /admin/config/user-fields
3. Click “Add user field”
4. Set up the field with appropriate options

Here’s an example of how your custom user field might look:

Use a dropdown field type with predefined options that exactly match your group Full Names. Free text fields can cause mismatches. If using a confirmation field type, the value will be “true” or “false”, so your group’s Full Name must be set accordingly.

Creating the automation

Now, set up the automation to add users to groups based on their custom user field selection:

1. Go to your site’s Admin area
2. Navigate to Plugins > Automation in the admin sidebar, or visit /admin/plugins/automation
3. Click “Add automation”
4. Select “Add user to group through User Custom Field” as the script
5. Choose a trigger:
   • “User first logged in” to add users to groups at signup
   • “Recurring” to run on a schedule, allowing users to change groups over time
6. Choose your custom user field from the dropdown menu
7. Configure the automation settings and make sure to enable it

Here’s an example of how your automation setup might look:

The automation includes a dropdown to select your existing custom user fields, making setup easier and less prone to errors.

Testing the setup

To ensure everything is working correctly:

1. Sign up as a new user or update an existing user’s profile
2. Select an option from the custom user field you created
3. Complete the signup or profile update process

Here’s an example of how the custom user field might appear during signup:

After the automation runs, you should see the user added to the appropriate group:

FAQs

Q: Can this automation add users to primary groups?
A: By default, this automation adds users to secondary groups. To set a group as primary, go to the group’s Manage > Membership settings page and select “Automatically set as primary group”.

Q: How often does the automation run if I choose the “Recurring” trigger?
A: You can set the frequency when creating the automation. Choose a schedule that best fits your community’s needs.

Q: What happens if a user changes their custom user field selection?
A: If you’ve set up a recurring automation, it will add the user to the new group based on their updated selection during the next run. However, the automation does not remove users from their previous group — it only adds. You will need to manage group removal manually if needed.

Q: How does the automation know which group to add a user to?
A: The automation matches the user’s custom field value against each group’s Full Name. There is no explicit group selection in the automation setup — the matching is automatic based on the Full Name.

Additional resources

• Creating and configuring custom user fields
• Setting a primary group for users

Last edited by @MarkDoerr 2026-02-03T23:57:30Z

Last checked by @hugh 2024-07-16T02:47:13Z

Check document

Perform check on document:

[JammyDodger]

This Automation has now been tweaked to include a dropdown to select your existing User Custom Fields from.

No more rooting around in the user custom field json trying to find an id number, or any awkward typos snarling things up. Just super smooth and friendly UI.

[sheng_hualuo (花落晓斩神)]

Pls the automation can only add users to the secondary group, what should I do if I want to add him to the primary group?

[JammyDodger]

I think this would be set on the group’s Manage/Membership setting page where you can select ‘Automatically set as primary group’.

[agemo]

What am I missing?

Did all of this but it is not working as expected after testing.

Do you need to match the “full name” of the group to the automation name option? i.e. I see no option to pick the group you want to the user to be added to on trigger event.

I’m missing a step or something is not clicking in my head.

[Moin]

Discourse Automation

The value of the custom field has to match the group name. So if your question is “what do you like more?” And your answers are “dogs” and “cats”, the full names of the groups must be “dogs” and “cats”. You cannot call them “dog lovers” and “cat lovers” There is a hint in the linked guide but I didn’t understand at first either.

[agemo]

Thanks, and so deleted all previous setups, sync name fields and tested signup. Still no success.

To confirm, you use the Group “full name” not the @name?

To add, I also changed the automation to recurring so I could trigger the automation manually and this also has not worked.

[Moin]

I just created everything from scratch:

1. My custom user field “Pet team”:
   

   

2. The new groups: Name “cat-lovers”, Full name “cat” and Name “dog-lovers”, Full name “dog”
   

   

3. The automation: (I chose every 1 minute for fast testing)
   

   

4. Testing

   1. Choosing “cat” for “Pet team” in my profile preferences
      
      
   2. Checking the group membership:
      
      
   3. Choosing “dog” for “Pet team” in my profile preferences
      
      
   4. Checking the group membership:
      
      

[agemo]

I was originally going to post a new topic “how to filter user signup before : after” so all new users from X day go into X group

However, I found this topic and decided it was what I needed.

The difference in my use case is to your example (thank you again) which is possibly even simpler, there is no need for multi chocie so the user only have to tick a “confirmation” and that confirmation field fix the users to X group

[agemo]

Also I can see the test user and the X filed = true in the user profile, so that works on signup.

AS outlined above in my case use there is only cat option and it is assigned by “confirmation” click, it is a mono filter requirement.

Maybe I’ll try force it using drop down instead and see if it works.

[Moin]

I also got a working automation using a confirmation custom user field.

[agemo]

Ok that was it, I changed custom user field to dropdown with only one option and it worked.

[agemo]

I can not replicate!

[Moin]

Does this help? Maybe you can spot the difference

The user field

The automation

The group

[agemo]

Your Group name is “true” ?

[Moin]

Yes, it must match the value of the custom user field. A confirmation field is either ‘true’ or ‘false’.

[agemo]

Ok, that is what I was thinking was going on.

It strikes me then you are then limited to one group called “true” and you can never user that “confirmation” approach again.

I will run with the drop down for now as I might want to change the group filter on say an annual basis, i.e. a group for each year.

Finally, if I can suggest to the makers of the automation, to perhaps consider a more explicit step and thus field, to specify the intended user group that is the target of your filter, as this implied part of the setup has caused me a lot of confusion and time as it probably as others.

Thank for all your help and exposé @Moin

[Moin]

I noticed some mistakes in the documentation:

@Discourse

Navigate to Users > User Fields

Actually, user fields are located in the community section of the admin sidebar.

@Discourse

• Go to your site’s Admin area
• Navigate to Customize > Automations

Automation is implemented as a plugin, so you will find it under Plugins rather then under Customize.

In general, the screenshots and the navigation seem a little outdated. Also, the common term seems to be “custom user field,” and this guide often uses “user custom field” instead.

Some time ago, I suggested an alternative version that reflects most of these points. I’m sharing it here now so it can help someone in case they’re struggling with these aspects.

My draft

This guide explains how to automatically add users to groups based on their selection of a custom user field during signup or profile update.

Required user level: Administrator

Summary

1. Set up a custom user field
2. Create the necessary groups
3. Create an automation to add users to groups
4. Test the setup

Setting up the custom user field

First, create a custom user field that users will select from:
(There is also a detailed guide on user fields)

1. Go to your site’s Admin area
2. Navigate to User fields using the link in the community section of the admin sidebar or by visiting /admin/config/user-fields
3. Click “Add user field”
4. Set up the field with appropriate options

Here’s an example of how your user field might look:

The automation assigns users to a group if their input in the custom field exactly matches a group’s full name. To ensure accuracy, use a dropdown with predefined options that match group names exactly. Free text fields can cause mismatches. If using a confirmation field, groups need to be named ‘true’ or ‘false’.

Creating the groups

Next, create the groups you want users to be automatically added to:
(There is also a detailed guide on creating groups)

1. Go to Groups by using the link in the admin sidebar or adding /g or /groups to your forum’s URL.
2. Click “New Group” for each group you want to create
3. Make sure to add a “Full Name” for each group, as the automation script uses this

The automation script uses a group’s Full Name, so ensure it exactly matches the input in the custom user field.

Creating the automation

Now, set up the automation to add users to groups based on their custom user field selection:

1. Go to your site’s Admin area
2. Navigate to Plugins > Automation
3. Click “Add automation”
4. Select “Add user to group through User Custom Field” as the script
5. Add a name
6. Choose a trigger:
   • “User first logged in” to add users to groups at signup
   • “Recurring” to run on a schedule, allowing users to change groups over time
7. Choose your user custom field from the dropdown menu
8. Don’t forget to enable your automation

Here’s an example of how your automation setup might look:

Testing the setup

To ensure everything is working correctly:

1. Sign up as a new user or update an existing user’s profile
2. Select an option from the custom user field you created
3. Complete the signup or profile update process

Here’s an example of how the user field might appear during signup:

After the automation runs, you should see the user added to the appropriate group:

FAQs

Q: Can this automation add users to primary groups?
A: By default, this automation adds users to secondary groups. To set a group as primary, go to the group’s Manage > Membership settings page and select “Automatically set as primary group”.

Q: How often does the automation run if I choose the “Recurring” trigger?
A: You can set the frequency when creating the automation. Choose a schedule that best fits your community’s needs.

Q: What happens if a user changes their custom user field selection?
A: If you’ve set up a recurring automation, it will update the user’s group membership based on their new selection during the next run.

Q: Can I use more than one automation based on a confirmation fields?
A: Yes! While both groups’ full names must be ‘true’ or ‘false’, you can create multiple groups with different names to distinguish them. When setting up the automation, simply select the respective custom field for each one.

Additional resources

• Creating and configuring custom user fields
• Creating groups in Discourse
• Setting a primary group for users

If I updated the documentation now, I would also add that there are issues when using a multi-select custom user field

[jenmck (jen)]

I have this set up, and noticed that when the user changes their preference in the user field dropdown, it does not remove them from the initial group they selected, but it does add them to the new group they selected. Is that the expected behavior?

That is, once the user is added to the group, is there no way to then remove them from the group via the automation?

[Paul_King]

System still not working at all for me, when the custom user field is a dropdown with multiple options