# Tags & facets

There are 3 types of Facets to use:&#x20;

1. Content (Exam, Module, Subject, Topic & Subtopic)
2. Skill
3. Difficulty&#x20;

The most important ones on platform are Subject, Topic and Subtopic as these are the ones used to display breakdowns to students. This article won't go into the details of making tags so please see our question creation articles for guides on creating tags in quizzes. If you need to bulk update questions with tags, use the importer.

📍 Approved characters in tags:  `!` `_` `(` `)` `<` `>` `.` `,` `+` `/` `:` `;`

Note any other characters in tags such as `&` will not be able to be created or imported &#x20;

{% content-ref url="/pages/-MkhEIUFDUCSEIeY6VYP" %}
[Creating a Quiz](/doc/quizzes/creating-a-quiz.md)
{% endcontent-ref %}

### 🏷 Tag manager

New tags will automatically be created and stored in the tag manager, or you can create tags here first by going to **Settings > Pages > Add Tag.** From the tag manager you can find the tag ID and label. You'll need the label to add tags to a spreadsheet or to questions in the builder. This is also where you'll assign facets to different tags

![](/files/fU95YHhvfQqeOtZK3fGE)

#### 📇 Labels

Capitals and spaces are accepted in tag label names. We recommend you keep the labels as short as possible so they display well on mixed screen sizes.

#### 👀 Visibility

Question tags do not show in attempts for exams and quizzes in timed or exam mode. They do show in practice mode as feedback is given after each question. Visibility refers to whether they are visible on the results (feedback) and insights page if these are configured for Students. New tags are visible to users on results pages by default. However, you may want to have tags that aren't visible to students. Change the visibility of a tag via the tag manager and tag editor. <mark style="background-color:yellow;">Note that faceted tags must be visible to students.</mark>

If a tag is faceted and you want to hide it from students, the facet must be removed first in order to update the visibility.&#x20;

An example of a tag you may want to hide from users is if you're using one for management purposes eg a tag like 'Batch 1 June Import' to help with your internal management of question banks

![Setting labels and visibility settings in the tag manager ](/files/TQ18dKp6yXtPdy69PpIH)

### 📚  Facets

From the tag manager you can assign different facets to different tags. Choose from the following :&#x20;

* **Content :** The content hierarchy looks like **Exam>Module>Subject>Topic>Subtopic**
* **Skill**
* **Difficulty**&#x20;

![Facet selector ](/files/Dw9lPgj44hqX3nfWWnrn)

Please see our facet best practices for more information and guidance on how to select facets for your tags. Use the chat function on platform to talk to an account manager who will make suggestions about how to order and facet your content&#x20;

{% content-ref url="/pages/2nc56hN8WuQgPO3sSVP7" %}
[Facet best practice](/doc/analytics/tags-and-facets/facet-best-practice.md)
{% endcontent-ref %}

&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.synap.ac/doc/analytics/tags-and-facets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
