> For the complete documentation index, see [llms.txt](https://salsa-digital.gitbook.io/govcms-site-builder/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://salsa-digital.gitbook.io/govcms-site-builder/unit-4-taxonomy-categorising-content/taxonomy-categorising-content/exercise-4-1-add-new-vocabulary.md).

# Exercise 4.1: Add new Vocabulary

Job seekers want to see content (including available jobs) that relate to a specific state/territory, such as ACT or Victoria. To meet this requirement, all Job Posting content on the site should be categorised by State/Territory. To do this, we’ll create a new vocabulary called ‘State/Territory’ and add terms to it (all of Australia’s states and territories).

In this exercise you’ll create a vocabulary, add terms and reorder the terms.

## Create a vocabulary and add terms

1. Go to *Structure* → *Taxonomy* and click **Add vocabulary**. Enter in the following information:
   * **Name**: State/territory
   * **Description**: Australian states/territories
   * Click **Save**.

     <figure><img src="/files/rbMIcKODILkEDpYrsQEC" alt=""><figcaption><p>Adding a State vocabulary</p></figcaption></figure>
2. You can now see the new *State/Territory* vocabulary on the main Taxonomy page (*Structure* → **Taxonomy**). Next you’ll need to add terms to the vocabulary. Click **List terms**.

   <figure><img src="/files/UtZFP3XGymFqaA2YW7nH" alt=""><figcaption><p>Showing "Add term" button in States vocabulary</p></figcaption></figure>
3. Click **Add term** button.
   * **Name**: ACT
   * **Description**: leave empty
   * **Relations**: leave all defaults
4. Click **Save.**

## Enter the rest of terms and re-order

1. Enter the remaining terms (in this case the remaining states and territories). Each time you save, the form will reload, ready for you to add more terms. Enter the following terms with a short description for each:
   * New South Wales
   * Victoria
   * South Australia
   * Western Australia
   * Northern Territory
   * Queensland
   * Tasmania
2. Navigate to the **list** of all terms in the vocabulary by going to *Structure* → *Taxonomy* → **State/territory**. By default the list is ordered alphabetically, but you can change the order by dragging the terms up or down. As an exercise, drag “Queensland” to the top of the list.

   <figure><img src="/files/9lfo1hMdXL4mXb3vIILB" alt=""><figcaption><p>Dragging Queensland term to the top</p></figcaption></figure>
3. Click **Save**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://salsa-digital.gitbook.io/govcms-site-builder/unit-4-taxonomy-categorising-content/taxonomy-categorising-content/exercise-4-1-add-new-vocabulary.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.