> For the complete documentation index, see [llms.txt](https://docs.digit.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digit.org/complaints-management/access/account-creation-and-onboarding-guide/complaint-template.md).

# Complaint Template

## Overview

This step determines what citizens can report, which department handles each problem, and how quickly it should be fixed (Service-Level Agreement).

#### How complaints are organised

* A complaint category is the broad problem a citizen picks. Example: Street lighting.
* A subcategory is a more specific problem inside it. Example: Broken lamp or Lamp on during the day.
* Each category is handled by one department.
* Each category has a resolution time assigned to it. After this time, the complaint shows as overdue.

{% hint style="info" %}
**Note:** This resolution time added here factors into auto-escalation at various intervals before and after an SLA (resolution time) is breached, as well as notifications triggered.
{% endhint %}

<div align="left"><img src="https://2002286464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK894BCuKVRy7QDBs06em%2Fuploads%2FFoBxT03MgW4mXIITRflZ%2Funknown.png?alt=media&amp;token=4fc32a90-9bf5-415d-b8a1-c7b460ce12eb" alt="" height="391" width="624"></div>

## Steps

### Step 1. Add a complaint category

1. Select Start from scratch (or Add category).
2. Type the Name. Example: Street lighting.
3. Under Handled by, choose the department. All subcategories go to the same department.
4. Under Subcategories, type one per line. This is optional; you can add more later.
5. Choose a Resolution time: 1 day, 3 days (the default), 1 week, 2 weeks, or a number of hours.
6. Select Add category to add the next complaint category.&#x20;

{% hint style="info" %}
**Note:** If a category has no subcategories, citizens report the category itself.

The level of hierarchy of complaint types is also configurable by the admin.
{% endhint %}

### Step 2. Save your onboarding progress

{% hint style="info" %}
**Important:** Your categories are kept as a draft, marked Unsaved, until you select Finish setup. Nothing is saved before then.

Finish in one sitting where you can. If someone else changes the categories in the meantime, your unsaved changes are dropped.
{% endhint %}

#### Before you finish

Finish setup stays greyed out until:

* You have added at least one complaint category with a department and a resolution time.
* Every department that receives complaints has at least one employee with the Complaint Assessor (GRO) role, and that department is their main department.

If a GRO is missing, you will see "No one can assign complaints for…" and the department names. Select Add a GRO in Employees, give someone in that department the Complaint Assessor role, then come back.

### Step 3. Add many categories at once (bulk upload)

1. Select Bulk upload.
2. Under Levels, the levels are set to two by default: a category level and a subcategory level. You can add more levels to this.&#x20;
3. Download the template, and fill in one row per subcategory. Repeat the category name on each of its rows.
4. Fill in Department Name with the department code, Resolution Time (Hours), and Search Words that citizens might type to find these categories.
5. Upload, check the results, and select Create.

<div align="left"><img src="https://2002286464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK894BCuKVRy7QDBs06em%2Fuploads%2FH7iiKLcYPj1slSfquIwx%2Funknown.png?alt=media&amp;token=a3eed55d-0288-4cca-bbcd-64f2c0804687" alt="" height="391" width="624"></div>

{% hint style="info" %}
**Important:** The upload suggests four levels by default. If you keep four levels, you cannot edit the categories in this step afterwards; you will have to do it in the management area.&#x20;
{% endhint %}

### Step 4. Finish setup

1. Review your categories, departments and resolution times.
2. Select Finish setup. You will see a confirmation such as "6 complaint categories are ready".
3. You are taken to the management area. Your account is now ready for citizens to report complaints.

{% hint style="info" %}
**Remember:** You can still change your branding, add departments, employees and complaint categories later in the management area.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.digit.org/complaints-management/access/account-creation-and-onboarding-guide/complaint-template.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
