Context:

If you have amenities that should only be accessible to users who have paid for them, creating and managing Access Groups in the ButterflyMX OS is the solution.

Scenario Example:
Let’s use an example with three devices: Main Entrance, Gym, and Bike Room.

• Staff members should have access to all devices.
• Residents should have access only to the Main Entrance.
• Residents with paid amenities should have access to the Main Entrance and either or both paid amenities (Gym and/or Bike Room).

Setting Up Access Groups

1. Log in to your ButterflyMX OS admin dashboard.
2. Go to the Access Management section.
3. By default, there is one Access Group called “default,” which includes all devices and users. You can add staff members and anyone else who should have unrestricted access to all devices into the “default” group.
4. To rename the “default” group for clarity (e.g., to “All Access”):
   1. Click on “default.”
   2. Update the name in the “Group Name” field.

Now, you have a group where any member has access to all devices.

Creating Access Groups for Specific Residents

To create an Access Group for residents who should only have access to the Main Entrance:

1. Click + Add Access Group.
2. Enter a name for the group (e.g., “Residents”).
3. Select the device(s) these users should access (e.g., Main Entrance), and set any time restrictions as needed.
   If no devices are listed, you can remove the group and add devices once they are installed.

Repeat this process to create separate Access Groups for the Gym and Bike Room.

In the end, you should have:

• An “All Access” group (staff and unrestricted users)
• A “Residents” group (Main Entrance only)
• A “Gym” group (paid gym users)
• A “Bike Room” group (paid bike room users)

This structure ensures only authorized users can access paid amenities, while general residents and staff have appropriate access.

Once you've set up the Access Groups, reach out to your Client Success Manager to set up the Directory. Currently, only ButterflyMX can select which access group is displayed in the Directory.

Changing or Adding Access Groups for a Specific User

How to Change a User’s Access Group

1. Go to the Tenants section.
2. Click on the user’s name.
3. Select Edit Tenant.
4. Scroll to the bottom and update the user’s Access Group as needed.

How to Change Access Groups at the Unit Level

If you want all current and future residents of a unit to be assigned to a specific Access Group, you can set this up at the unit level. Any new user added to that unit will automatically be placed in the designated Access Group.

1. Go to the Spaces section.
2. Click Edit next to the relevant unit.
3. Select the desired Access Group for the unit.