Skip to main content
All CollectionsConnecting iQualify to other systemsIntegration
Overview of how to add custom tags to courses
Overview of how to add custom tags to courses

You can add custom tags to store additional information about courses that you can then share with other apps via APIs and the Event Hub.

Christine Nicholls avatar
Written by Christine Nicholls
Updated over a week ago

When integrating iQualify with other apps using the API or the Event Hub, you can pass additional information about courses and course activations to these other apps using custom tags. This information can help with the integration (e.g. using the course code) or it could allow the filtering of courses according to location, target market, or any other additional criteria that is important to your organisation. Tags can be added to a course or a course activation at any point in time.
Once you have decided which information you want to add to a course, you can enter this information into iQualify in several ways.

Add tags as an author

As an author, you can set goals/outcomes for a course and you can also tag various levels of course content.

You can add tags to:

  • The course as a whole

  • Individual pages

  • Individual tasks or quizzes

Add tags with manage access

As a manager, you can add tags under Details when you are editing a class activation. See Editing the details of a class activation for full instructions.

Add tags as an integration engineer

As an integration engineer, you can also add or update tags for an editable course using the Update course tags API.

To add or update tags for an active course you can use the Update offering tags metadata API.

The process for updating via the API is similar to the one for updating user tags, described in the following article: Adding tags to users using Zapier.

Note: A task will get a new taskId whenever it is edited by an author. However, the tag for that task, will remain the same. This is why it's a good idea to use tags for tasks when creating any integrations etc.

Why add goals and tags?

But why would you allocate tags to a course, page or task? Well it means that the course/page/task now has extra data attached that you can use to filter, find or group things. For example:

Maybe you want to add a course code tag to let you map the iQualify course to your SMS and/or course catalogue?

Maybe you want to add a region/location tag to courses to allow you to filter/select class activations by campus location?

Maybe you want to add page tags to see if there's a pattern in which pages learners are getting the most visits? For instance:

  • Are most learners are skipping the pages relating to LO1.2?

  • Are learners repeatedly viewing pages with discussions or assessments?

  • Are learners are skipping the tasks that scaffold to the first assessment and then doing poorly in the assessment?

Understanding events and associated data

To understand a little more about how this works and what needs to happen... we need to talk about events within iQualify and how you can gather data about events and send them somewhere e.g. to a spreadsheet.

When a learner does certain things in iQualify - views a page, submits a task etc. - we capture that "event". And events can have other data associated with them for instance in terms of viewing a page, we also capture who viewed that page and at what time.

And account owners can setup events such that whenever event 'x' happens, event data is sent to 'y' (connected app, zapier, spreadsheet etc.).

If your course, pages, tasks or quizzes have tags attached, your event will have that tag data too.

This means, if you're capturing data about the viewed a page event, you can use those goals/tags to filter, find, or group. You can get more insights from the event. For instance, you could group pages with the tag "Discussions" and pages with the tag "Video" to see which are getting more views.

Other articles you may be interested in:


Did this answer your question?