To add a new user and new location to your platform. The first thing you need to do is make sure you are in the correct Organization where the user and the location are going to live. Best Practices state that the User, Location, and User filter will all be in the same organization. If you have a multi-org environment, change orgs and navigate there now.
Here is a quick summary of what we are going to do.
Create the Hierarchy Tags for the new location by going to Tags.
Create the User Filter for the new location in Filters.
Create the new location in Locations:
Make sure to add the hierarchy tags.
Make sure to assign the new User Filter.
Create the User account and add the proper hierarchy tag.
Let's show you how to do this.
I have a new location that is going to be coming online. Here is the information I have for the location:
Location Name: Comedy Works
Location Address: 1226 15th Street Denver Colorado 80126
Location Hierarchy: Denver District, West Region
Store Account email address: comedyworks@test.com
I know that the hierarchy for the location needs to include the following levels. Your hierarchy can have as many or as few levels as needed for your organization but a store hierarchy must always include the Store Level and Corporate Level.
To define these levels in the system I am going to create the following tags for each level in the organization.
Store Level: Comedy Works (should be named exactly as the Location Name)
District Level: Denver District
Region Level: West Region
Corporate Level: All Locations
Tags:
Go to Admin - Tags
You will need to create/confirm that you have the following tags in the platform before proceeding to the next step.
Comedy Works
Denver District
West Region
All Locations
For instructions on how to enter tags, click here.
User Filters
We now need to create a new User Filter for the location. For more information on creating User Filters, click here.
Go to Admin - Filters - User and click + New Filter in the upper right corner.
Name the User Filter the same name as the store, in this case, Comedy Works.
Then on the first row, add the Comedy Works Tag.
Press + and add another filter parameter.
When you press plus the operator is going to default to And Also you want to switch that too Or Else.
For a standard User Filter you only want to use Or Else and Tagged With Logic.
Add the next tag: Denver District.
Repeat this process until your filter has all 4 hierarchy levels in it.
When you are done building your User Filter Click Create Filter.
Note that you won't have results until you create your filter and the platform has a couple of minutes to run the filter and gather results. You don't have to wait for this process to finish, you can move on to the next step.
Create Location
Go to Admin - Locations - + New Location
Create the Location by entering the name, tags, and address. For more information on how to create a location, click here.
Make sure to include all four hierarchy tags on your location.
Make sure to select the User Filter from the User Filter Drop Down.
Your Location Should look like this when configured.
Notice how we named the User Filter, the Location, and the Location Tag exactly the same. That is a naming convention and you should always name things exactly the same when possible. It makes it much easier to keep track of the different entities in the system.
Create User
Go to Admin - Users - + New User
For more information on creating Users, click here.
We need to create the User Account for this location.
Enter all of the information.
For the Tag because this is a Store Level Account we have to tag the User with Comedy Works.
If this was the Denver district manager then we would tag that User with Denver District.
If this was the regional manager we would take them with Western Region.
If this was a corporate employee who can see all locations we would tag them with All Locations.
Locations and User Filters will always have multiple hierarchy tags, Users will always only have 1 based on their level in the hierarchy.
Your user account should look like this.
You have now created a new location and user that are fully configured.
The key to ensuring that a user sees the locations that they are supposed to see is tag agreement between the User, the Location, and the User Filter assigned to the location.
When the User is tagged with a tag that appears on the location and in the Location's User filter that is tag agreement and that is what is necessary for the platform to work as designed.
Rember you have to select the user filter on the location for it to do its magic.