---
title: "Available audience upload fields"
slug: "available-audience-upload-fields"
tags: ["Totara Platform", "Reference", "Site Administrator"]
updated: 2026-08-13T16:01:10Z
published: 2026-08-13T16:01:10Z
canonical: "totara.help/available-audience-upload-fields"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://totara.help/llms.txt
> Use this file to discover all available pages before exploring further.

# Available audience upload fields

There are several fields you can use when creating a CSV file to [upload audiences](/totara-20/docs/upload-an-audience) to your site.

## **Required fields**

| **Field name** | **Description** |
| --- | --- |
| name | The name of the audience. |

## **Optional fields**

To provide values other than the default, include one or more of the following optional fields.

| **Field name** | **Description** |
| --- | --- |
| contextid | Use this field if you wish to specify the context ID for the audience you are uploading. This could be the context ID of a specific course category. |
| idnumber | Assign a unique alphanumeric ID to the audience. |
| description | You can describe the audience, which can help others to use it. |
| descriptionformat | Specify the text editor formatting type you'd like to use for the description. Choose from: - **0** for Totara auto-format - **1** for Atto HTML editor - **2** for Plain text format - **3** for HTML format - **4** for Markdown format |
| visible | You can either set the audience to: - Visible using **1** - Hidden using **0** |

## **Additional fields**

You can use additional fields to link to information elsewhere on the system. As most of the additional fields involve looking up information from other parts of the system, it is advised that you use these with caution.

| **Field name** | **Description** |
| --- | --- |
| context | Enter the context of the audience being uploaded. For example, use **system** for a site-wide audience. |
| category | Associates the audience with a particular course category named here. |
| category_id | Associates the audience with a particular course category using that category's ID. |
| category_idnumber | Associates the audience with a particular course category using that category's ID number. |
| category_path | Associates the audience with a particular course category using that category's path. |

![Course badge](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/course-badge_audiences.svg?sv=2026-02-06&spr=https&st=2026-11-06T06%3A53%3A19Z&se=2026-11-06T07%3A53%3A19Z&sr=c&sp=r&sig=thZqkwDKOYS2x7tXScLKUwumcFheg%2B9AzKtI4hS5FeQ%3D)Why not visit the Totara Academy for our latest course on [Audiences](https://totara.community/mod/page/view.php?id=24689) in Totara. Here you can learn more on how to use audiences, see best practice, and give it a go yourself.

Join the [Totara Community](https://totara.community/) for more resources to help you get the most out of Totara.

© Copyright 2026 Totara Learning Solutions. All rights reserved.