> For the complete documentation index, see [llms.txt](https://docs.moodly.education/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moodly.education/features/settings-and-customisation/customising-affirmations.md).

# Customising Affirmations

This feature is all about reinforcing positive thinking and boosting student self-esteem. During these check-ins, students receive encouraging affirmations designed to uplift their mood and foster a positive mindset.

Within Class & School settings we allow for full customisation of affirmations.

Affirmations can be configured to either capture emojis representing an affirmation or a custom Survey can be used.

### Using Emojis

| Field                     | Description                                                             |
| ------------------------- | ----------------------------------------------------------------------- |
| Affirmation Question Text | Change the prompt shown to learners when registering their affirmations |
| Free Text Affirmations    | Allow Learners to enter their own affirmations                          |
| Number of Affirmations    | The number of affirmations each learner should record each time         |
| Affirmations              | See below                                                               |

Affirmation options can be configured in a similar way to Zones.

You can add and remove options using the Affirmations section at the bottom of the screen.

<figure><img src="/files/tn3gOV85YlCfdlkrRs0V" alt=""><figcaption></figcaption></figure>

Clicking add allows you to add an option

<figure><img src="/files/pZ4JMkjFIJCYYAecdadG" alt=""><figcaption></figcaption></figure>

To remove an option click the Trash icon on the option

<figure><img src="/files/JO5wgbszqCfVCzN8YRSU" alt=""><figcaption></figcaption></figure>

Remember to Save after changing your configuration!

<figure><img src="/files/w4SXOBZ0DQKLrjgTOJ9p" alt=""><figcaption></figcaption></figure>

### Using Surveys

Selected "Survey" from the dropdown allows you to configure a Survey response to an affirmation checkin. This allows for a far greater level of detail/customisations for your affirmation check-ins.

<figure><img src="/files/ILthdZOEqDZS0bX4ByS1" alt=""><figcaption></figcaption></figure>


---

# 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://docs.moodly.education/features/settings-and-customisation/customising-affirmations.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.