Tags

Tags

Cognassist

Tags

Group learners in the way that suits your organisation, then find, filter and export them by those groups.

What a tag is

A tag is a short label you choose, such as Sept-2026 or Cohort:A. Your organisation keeps its own list of tags, and each learner can have up to 10.

Tag rules

RuleDetail
Length3 to 20 characters
CharactersLetters, numbers, colons (:) and hyphens (-). No spaces, apostrophes or brackets.
Per learnerUp to 10 tags
MatchingNot case-sensitive, so Cohort-A and cohort-a are the same tag
ExamplesSept-2026, Cohort:A, Year-2

If a name breaks a rule, you're told which rule and the tag isn't saved.

Add or remove tags on a learner

1

Open the learner

Go to the learner's Details tab.

2

Choose or create a tag

Start typing in the Tags field. Pick an existing tag, or type a new name to create it.

3

Remove a tag

Remove it from the Tags field.

4

Save

Save the learner's details. Tag changes are saved with the rest of the form.

There's no separate step to create a tag. A tag is created the first time it's given to a learner.

Find learners by tag

 
On the Learners list, open the filters and choose one or more tags in the Tag filter.
 
Choosing several tags shows learners who have any of them.
 
Bulk actions on a filtered list only include the learners shown.
 
The reporting, update and evidence exports include the same learners as your filtered list.

Tag learners in bulk by CSV

 
The learner add and learner update CSV imports accept an optional Tags column.
 
Separate several tags with semicolons, for example Sept-2026;Cohort:A.
 
Tags your organisation doesn't have yet are created when the file is imported.
 
Each row is checked against the tag rules and the 10-tag limit. A row that breaks a rule is rejected on its own, and the rest of the file still imports.

Manage your organisation's tags

Client Admins can see and tidy up the whole tag list.

1

Open the Tags tab

Go to Organisation settings > Tags. You'll see every tag and how many learners hold it.

2

Delete a tag

Choose delete. The confirmation shows the tag and how many learners have it.

Deleting a tag removes it from every learner who has it, straight away, and can't be undone.

Tags can't be renamed or merged. To rename one, give the new tag to the learners, then delete the old one.

Tags and locations

Locations are kept separate from tags. A name can be a tag or a location, not both, and a learner's location doesn't count towards their 10 tags.

Using the Public API

 
List your organisation's tags with GET /v1/tags, and delete one for the whole organisation with DELETE /v1/tags.
 
List, add and remove a learner's tags with GET, POST and DELETE /v1/learners/{learnerId}/tags.
 
Adding is additive: tags the learner already has are left alone, and new tags are created.
 
There's no single call to clear all of a learner's tags. Remove them one at a time.
 
You can also include tags when you create a learner.

Read the developer docs

FAQs

Do tags change who can see a learner?

No. Tags are labels for organising, filtering and exporting learners.

Why can't I use spaces?

Tag names allow letters, numbers, colons and hyphens only. Use a hyphen instead, such as Year-2.

What happens to tags when a learner is deleted or anonymised?

The learner's tags are removed. The tags themselves stay in your organisation's list.

Can I rename a tag?

No. Give the learners the new tag, then delete the old one in Organisation settings > Tags.

Need a hand?

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