Locations in Cognassist

Locations in Cognassist

Cognassist

Locations

Record which site each learner and tutor belongs to, so you can find and export learners by site.

What a location is

A location is one of your organisation's sites or campuses. Each learner can have one location and each tutor up to 10. Locations are for filtering only: they don't change who can see a learner.

Location rules

RuleDetail
Name3 to 50 characters, starting with a letter
CharactersLetters, spaces, hyphens (-), ampersands (&) and apostrophes (')
Per learnerOne location
Per tutorUp to 10 locations
Unique namesA name can be a location or a tag, not both
Who can add or changeClient Admins

Give a learner a location

1

Open the learner

Use Add learners, or open the learner's Details tab and find Programme details.

2

Choose or create a location

Pick one from the Location field, or type a new name to create it.

3

Save

Save the learner. To remove a location, clear the field and save.

The location is saved just after the learner's details. If it can't be saved, you'll see a message saying the learner saved but the location didn't. Other users see the location but can't change it.

Give a tutor locations

1

Open the staff record

Open the tutor and find the Locations section.

2

Add locations

Pick from your organisation's locations, or type a new name. A tutor can have up to 10.

3

Save

Save the staff details. Location changes are saved straight after.

The Staff table shows each tutor's locations in a Locations column.

Find learners by location

 
On the Learners list, use the Location filter to choose one or more locations. Learners in any of them are shown.
 
Switch on Learners without location to find learners who still need one.
 
Add the optional Location column to the list. It's off by default.
 
Bulk actions and exports include the same learners as your filtered list.

Exports

 
The reporting export includes a Location column.
 
The update export includes an empty Location column. Fill it in and re-upload the file to set learners' locations. A blank cell leaves a learner's location as it is.
 
The evidence export follows the location filter but has no Location column.

Add locations in bulk by CSV

ImportColumn
Staff importLocations (Optional): several per tutor, separated by semicolons, up to 10
Learner add importLocation (Optional): one per learner
Learner update importLocation: one per learner
 
Names your organisation doesn't have yet are created on import.
 
A blank cell, or a missing column, changes nothing. An import never clears a location.
 
A row is rejected on its own if a name breaks the rules or is the same as one of the learner's tags. The rest of the file still imports.

Manage your organisation's locations

1

Open the Locations tab

Go to Organisation settings > Locations. You'll see every location and how many tutors and learners hold it.

2

Delete a location

Choose delete. The confirmation shows the location and both counts.

Deleting a location removes it from every tutor and learner who has it, and can't be undone.

There's no create or rename on this tab. A location is created when you first give it to a learner or a tutor.

Using the Public API

 
List, create and delete your organisation's locations with GET, POST and DELETE /v1/locations.
 
Get, set or clear a learner's location with GET, PUT and DELETE /v1/learners/{learnerId}/location. Setting a location replaces the learner's current one.
 
List, add and remove a tutor's locations with GET, POST and DELETE /v1/staff/{userId}/locations.

Read the developer docs

FAQs

Does a location limit who can see a learner?

No. Locations are for filtering and exporting only.

Can a learner be in two locations?

No. A learner has one location. A tutor can have up to 10.

Can I rename a location?

No. Give learners and tutors the new location, then delete the old one in Organisation settings > Locations.

Can a learner's location be different from their tutor's?

Yes. A learner's location doesn't have to match any of their tutors' locations.

Need a hand?

Talk to your Customer Success Manager. They can help you set this up for your organisation.