Locations filter

About Locations

Locations is one of the three primary filters in the Jostle® platform. Each user can be assigned to multiple Official Locations, and this can be done via:

• A user's Profile card in People (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 other methods, bulk uploading and user-controlled updating, are explained below.

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 Official Locations (NOTE—modified names cannot be translated into other languages). 

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

Table of contents:

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

1. Optimizing the Location filter hierarchy

Alias

Each Official Location is required to be designated by 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

Official 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 can see the hierarchy created by the filter by looking at it in the People view filter panel:

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. entering "Vancouver, BC" in the City field). 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 Official Locations

Official Locations are managed by System Administrators at Administration settings > Filters and badges > Configure Official Locations (Location). At the top of the screen is where you can change the "Locations" label:

Further down, you add new Official Locations, or edit or delete existing ones.

To add a new Official Location

1. Go to Admin Settings > Filters and badges > Configure Official Locations (Location)
2. Scroll down to Add an Official Location and enter an Address Alias name. This should be short and be the common name used for this location (e.g. the building's nickname).
3. Fill in the rest of the location information and the click the Save button. What you fill in here determines how the Filter hierarchy will appear when it is used (see the section above for more on this). 

Export/Import of Locations

There is also an option available at the bottom of this screen to export your current Locations data via CSV. This would be helpful if, for example, you wanted to export all your Locations and make bulk edits via CSV (for example, to create a consistent hierarchy of Country, State, and City), and then import the CSV back to apply your updates. 

You can import your updated Locations CSV via the Upload section: click Choose file to locate your CSV and then Upload.

• If you haven't added any Locations data to your intranet 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 intranet, 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.