Locations Filter


About Locations

Locations is one of the three primary filters in your Jostle platform. System Admins can use them to represent the physical locations of their organization. Each user can be assigned to multiple official Locations, and this can be done via:

  • A user's Profile card in People (Profile card > Edit > Locations)
  • The Create a New User/Edit User pages in Admin Settings > User Accounts and Data
  • The Extract/Manage All User Data page in Admin Settings > User Data To/From Other Systems

Two additional methods, bulk uploading and user-controlled updating, are explained below.



Locations are optional. If you have none defined, this filter will not appear in the platform. 

You can also automate the process of maintaining your Locations by using SFTP to connect with other systems. See this article for more details.

Locations (the filter) can be renamed by System Admins at Admin Settings > Filters and Badges > Configure Locations (see more below, under "Exporting/Importing/Renaming of Locations").

NOTE—modified names cannot be translated into other languages. 



Table of contents:

  1. Optimizing the Location filter hierarchy
  2. Managing Locations
  3. Assigning Locations via bulk uploading
  4. Allowing users to update their own Location
  5. Other Locations


1. Optimizing the Location filter hierarchy


Each Location is required to be designated by a Name (formerly an "Alias"). This should be the common name that people use for that location. Something like “London campus”, “Georgia Street Office” or “Building 3”.

City, State/Province, Country

Locations can also have a city, state/province, and country associated with them.  These are optional, but if you do include them, they will auto-create a hierarchy in your Location Filter. This makes it easy, for example, to publish something to all locations in a certain country or city.

It is recommended that you take some time to get familiar with this setup so you can get your Location filter optimized for easy use. You'll be able to see the hierarchy created by the filter once you set it up if you go to People and click the Filters and Settings icon at the top of the screen:




And then expand the Locations field:




Note that you can partially collapse the structure and produce a flatter hierarchy by placing city and state/province in the same field (e.g. "Vancouver, BC") in the City field on New Location form (detailed in the next section). This helps provide a cleaner look if, for example, you have multiple Locations within a particular city or state/province:




And the fewer fields you use to define your Location, the flatter your list will be.





2. Managing Locations

Locations are managed by System Administrators at Administration settings > Filters and badges > Configure Locations




To add a new Location

  1. On the Configure Locations screen, click the "+"
  2. On the New Location modal, enter a Name for your Location (e.g., the common name used to refer to the location).
  3. Fill in any of the Optional Information fields that you'd like to include to identify your new Location (External ID, Street address, etc.).The more information you add will determine how this Location appears in the filter hierarchy (as explained above).
  4. Click Save in the top corner.
  5. Your new Location should now be showing on your Locations list.


To edit a Location

  1. Open the action menu for the Location you wish to edit.
  2. Select Edit from the menu.
  3. Make your changes then click Save.



Exporting/Importing/Renaming Locations

Click the three dots next to the "+" on your Locations list to open the action menu. From here you can choose to export or import your Locations data or edit your Locations filter name.



Export all Locations to CSV

Select this to download your current Locations data. 

This would be helpful if, for example, you wanted to make bulk edits to all your Locations via CSV (for example, to create a consistent hierarchy of Country, State, and City), and then import the CSV back to apply your updates. 


Import all Locations from CSV

Select this to import your updated CSV. On the Import Locations screen, check off your desired options, click Choose file to locate your CSV, and then Upload.




Edit Locations filter name

Select this if you want to change the name of the Locations filter and repurpose it for something other than locations.




If you haven't added any Locations data to your platform at all, you can use the blank CSV template found at the bottom of this page to enter your data upload it in bulk. However, this is not advisable for uploading new Locations if you already have existing Locations data entered in your platform, as you run the risk of accidentally removing those Locations if you don't check the proper settings before uploading or don't include them in your CSV (along with any new Locations you're adding). Better to use the Export Locations link and just add your new Locations to that CSV, and then re-import it.


3. Assigning Locations via bulk uploading
Locations can be updated for each user via a bulk upload. See this article for further details on bulk uploading. When updating the Locations for users, use "Location" as the CSV column header and enter the desired Location Name for each user. To enter multiple Names for a user separate them with the pipe character "|" in the CSV file.

4. Allowing users to update their own Locations
Once your Locations are set up, you can let your users self manage the correct Locations for them. System Admins can enable this by going to Administration settings > User Profiles > Configure user Profiles fields. Once enabled, an Official Locations dropdown menu appears when in Edit mode, in the Info Tab of each user's Profile:
When you click on this dropdown, all the official Locations of your org appear in their set hierarchy:

 5. Other Locations
In addition to their Official Location, if a user has a personal or remote location they also work from, they can add this to their Profile as their Other location. (Profile > Info Tab > Edit button > Other). This will appear directly below their Official Location information. Locations that are set on a per user basis like this are not included in the Locations filter.
NOTE—If you don't have a need for a Locations filter, then it can be repurposed for something other than Locations (see section 2 above, under "Edit Locations filter name"). For example, if you have employee types that need to be organized in a hierarchy, like all Leadership roles (e.g. Department Managers > Supervisors > Team Leads) and therefore do not fit with the flat format of the Custom Filter you could repurpose the Locations filter to do this.


However, this can be a little tricky, as you would still have to enter your values in fields labeled "City", "State", etc. and have to keep track about where to enter what. 


Locations CSV template
Was this article helpful?
4 out of 4 found this helpful
Have more questions? Submit a request


Please sign in to leave a comment.