> ## Documentation Index
> Fetch the complete documentation index at: https://docs.softr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# User Groups

> Create, manage and utlize custom user groups in Softr.

User groups are an essential part of delivering a personalized experience and showing the right information to your users. In addition to making blocks and pages accessible to logged-in or non-logged-in users, Softr allows you to create custom user groups.

Let's start with how user groups are created.

<Tip>
  Note that in order for changes to user groups to take effect, the application needs to be [published](/publishing/9qTmU2Lj8Gnpr1Ue6dEAkX/publishing-your-softr-app/gRrb1u7eLmRTrXyg3UNGkQ) after making the changes.
</Tip>

## Create a user group

To create a user group head to users and hit add user group.

<Frame caption="Create a new user group">
  <img src="https://mintcdn.com/softr-2b8a27e1/VMGEt-PtN3_foPwS/user-groups-and-permissions/images/user-groups/image1.png?fit=max&auto=format&n=VMGEt-PtN3_foPwS&q=85&s=56ffd994532979650b6d241ffed9cf1b" alt="Create a new user group" width="1681" height="574" data-path="user-groups-and-permissions/images/user-groups/image1.png" />
</Frame>

Name your user group, and voila! Your user group is created. But we're not finished yet. Next, you'll need to add users to your user group.

<Frame caption="Name your user group">
  <img src="https://mintcdn.com/softr-2b8a27e1/VMGEt-PtN3_foPwS/user-groups-and-permissions/images/user-groups/image2.png?fit=max&auto=format&n=VMGEt-PtN3_foPwS&q=85&s=5eb311ef5017db9bc4bba173a95cf7b9" alt="Name your user group" width="1960" height="1328" data-path="user-groups-and-permissions/images/user-groups/image2.png" />
</Frame>

## Add users to your user group

Once you have a user group, you need to add users to it. You can do this manually or by adding users based on their attributes with conditions.

### Add users manually

To add users manually, select one or more existing users from the dropdown list.

<Frame caption="Add users manually to your new user group">
  <img src="https://mintcdn.com/softr-2b8a27e1/VMGEt-PtN3_foPwS/user-groups-and-permissions/images/user-groups/image3.png?fit=max&auto=format&n=VMGEt-PtN3_foPwS&q=85&s=9b26b7c965ce2920af20fdd39c856f88" alt="Add users manually to your new user group" width="1960" height="1556" data-path="user-groups-and-permissions/images/user-groups/image3.png" />
</Frame>

You can also manually assign a user group to a user from the users table.

<Frame caption="Add users manually directly from the users table">
  <img src="https://mintcdn.com/softr-2b8a27e1/VMGEt-PtN3_foPwS/user-groups-and-permissions/images/user-groups/image4.png?fit=max&auto=format&n=VMGEt-PtN3_foPwS&q=85&s=c4de90272c10e2dba9e04407f1cdc0b3" alt="Add users manually directly from the users table" width="2560" height="1600" data-path="user-groups-and-permissions/images/user-groups/image4.png" />
</Frame>

### Add users based on a condition

Select a logged-in user's attribute and specify a relevant condition and value.

<Info>You can learn more about using conditional filters here → [Conditional Filters](/user-groups-and-permissions/3oA6AaFzUiePs2sW2TpYrF/conditional-filters/mDnn7jnpPiYmJcT99jpt7m) </Info>

You can also specify conditions based on payment-related attributes, such as one-time products and subscriptions. To use these attributes, you must connect Stripe to your application. [Learn how to add users based on their Stripe attributes](/how-to-guides/ioi5BbuQ2RDM7aHPrpXnjG/add-users-to-user-groups-based-on-stripe-attributes/g1A2tEtjvmiCtGL1hgJmMe).

<Frame>
  <img src="https://mintcdn.com/softr-2b8a27e1/VMGEt-PtN3_foPwS/user-groups-and-permissions/images/user-groups/image5.png?fit=max&auto=format&n=VMGEt-PtN3_foPwS&q=85&s=4f3b6843fca5ac60a7f549c3fe6280d1" alt="Notion image" width="717" height="875" data-path="user-groups-and-permissions/images/user-groups/image5.png" />
</Frame>

## **Manage user groups for each user from the users table**

A user's user groups are visible in the users table. You can see which user groups they're in, and you can assign and remove any user group they were added to manually.

However, you cannot remove a user from a user group they were added to based on a condition. This is because of the rule yourself or a collaborator set up when creating the user group. To edit the conditions for a user group, go to the user groups tab and edit the condition(s) used to add users.

<Columns cols={2}>
  <Frame>
    <img src="https://mintcdn.com/softr-2b8a27e1/VMGEt-PtN3_foPwS/user-groups-and-permissions/images/user-groups/image6.png?fit=max&auto=format&n=VMGEt-PtN3_foPwS&q=85&s=149f5be18b530c90324facd3c0d81944" alt="Notion image" width="2560" height="1600" data-path="user-groups-and-permissions/images/user-groups/image6.png" />
  </Frame>

  <Frame>
    <img src="https://mintcdn.com/softr-2b8a27e1/VMGEt-PtN3_foPwS/user-groups-and-permissions/images/user-groups/image7.png?fit=max&auto=format&n=VMGEt-PtN3_foPwS&q=85&s=f43eea5c68938c1ffdd16989be42fa8b" alt="Notion image" width="2560" height="1600" data-path="user-groups-and-permissions/images/user-groups/image7.png" />
  </Frame>
</Columns>

## Set block and page visibility for your user group

Once you've created a user group, you can use it to control who can see a particular block or page.

To set block visibility, go to the block's visibility settings, select Logged-in users, and select the relevant user group from the dropdown list.

To set page visibility, go to the page's settings, select Logged-in users, and select the relevant user group from the dropdown list.

Now, only users in the selected user group will be able to see the block or page.

<Frame caption="Setting block visibility for a user group">
  <img src="https://mintcdn.com/softr-2b8a27e1/VMGEt-PtN3_foPwS/user-groups-and-permissions/images/user-groups/image8.gif?s=d530257281f478631caa588b2f31d2cd" alt="Setting block visibility for a user group" width="2868" height="1416" data-path="user-groups-and-permissions/images/user-groups/image8.gif" />
</Frame>

## Set advanced action permissions for your user group

You can also use user groups to control who can perform specific actions on a block.

To do this, go to the relevant block and open the Button visibility settings from the Actions tab. From there, you can define which user groups should be able to see and interact with the action.

<Columns cols={2}>
  <Frame caption="Open action button visibility settings">
    <img src="https://mintcdn.com/softr-2b8a27e1/VMGEt-PtN3_foPwS/user-groups-and-permissions/images/user-groups/image9.png?fit=max&auto=format&n=VMGEt-PtN3_foPwS&q=85&s=56097a53808ba71edaa33c90aef9c729" alt="Open action button visibility settings" width="888" height="870" data-path="user-groups-and-permissions/images/user-groups/image9.png" />
  </Frame>

  <Frame caption="Select the user groups that can see and interact with this button">
    <img src="https://mintcdn.com/softr-2b8a27e1/VMGEt-PtN3_foPwS/user-groups-and-permissions/images/user-groups/image10.png?fit=max&auto=format&n=VMGEt-PtN3_foPwS&q=85&s=3c8cbc61aac797effa120cc2e236b933" alt="Select the user groups that can see and interact with this button" width="837" height="901" data-path="user-groups-and-permissions/images/user-groups/image10.png" />
  </Frame>
</Columns>

## Edit, duplicate, remove user group

You can manage your user groups by navigating to Users > User Groups and hovering over relevant user group.

<Frame>
  <img src="https://mintcdn.com/softr-2b8a27e1/VMGEt-PtN3_foPwS/user-groups-and-permissions/images/user-groups/image11.png?fit=max&auto=format&n=VMGEt-PtN3_foPwS&q=85&s=f1efba8cd0e2687055c9f29bd8ef9916" alt="Notion image" width="2652" height="794" data-path="user-groups-and-permissions/images/user-groups/image11.png" />
</Frame>

## Security

<Tip>Softr viability checks and record conditional filters are applied on the server side, and there is no way to trick the system. Learn more about [Softr App Security](/security/ummZ2CWNHXZCHzsZwbEwET/softr-app-security/1xC7Hgkvo67AnHKyebr1uC).</Tip>
