# Simple scoring

Scoring is a very useful tool to keep your users motivated and updated about their progress in the learning journey. Once you start assigning scores to your prompts, the maximum achievable score of any flow can be seen on the preview panel at all times.

![](/files/KmldrHqp4JmRhVEhxp4C)

DialogForm allows you to score multiple choice prompts as well as free-form/subjective answer prompts in various ways. Here we show you how to score multiple choice prompts.

## Multiple Choice Prompts

### What To Do

Create a prompt with answer options.

![](/files/KaAxuwMt9hA8qDPgbqzu)

To add a score to the correct answer, hover over the <img src="/files/pqNJr08A79HGYJYGg73L" alt="" data-size="line"> icon that appears to the right of the answer, and select "Add Score" in the menu that opens up as a result.

You will see a<img src="/files/5Bj0EMsIWR4Q9W7ZGN57" alt="" data-size="line">pop up right above the answer. Click on it and customize your score <img src="/files/IXDdf5iKburBIjqMsXKh" alt="" data-size="line">. Negative numbers are fine too. To remove the score, just delete the value entered.

Now, when your users select the correct answer option, they will be awarded the assigned score automatically.

![](/files/URkx6FzGzT9k0MRUnaUm)

You can assign zero scores to the incorrect answers, if you wish. Or maybe you have some partially correct answers for which you can assign lower-than-full scores.

{% hint style="warning" %}
**Note that there is a distinction between assigning a zero score and not assigning a score at all**.&#x20;

It isn't necessary that if one option has an assigned score, all other options must have one too. You could very well choose not to assign a score to some options.

For example, you could make one of your options *`"I don't know, can you help me out a little?"`.* Clicking on this option could lead to a prompt (or series of prompts) where you provide a hint to the user, then have them answer again, maybe playing for less points this time.
{% endhint %}

## **Free-form Objective Answer Prompts**

### **What To Do**

Note that this section only applies to **non-subjective** free-form answer prompts. By this we mean prompts that have clearly defined correct and possibly any partially correct answers, just like multiple choice prompts. The only difference is that these prompts allow you to test your users knowledge without giving them options to choose from. You can learn all about free-form non-subjective prompts in the first part of the this article:

{% content-ref url="/pages/mWm9rzd0xgm0KYhVm8Lp" %}
[Free-form/Subjective answer prompts](/user-guide/free-form-subjective-answer-prompts.md)
{% endcontent-ref %}

Here is an example of such a prompt:

![Editor](/files/uGQc9nRvk2MQmLnX2cXt) ![Preview](/files/9cWAy38beVTiucDx7ajh)

It asks the user a question, and presents a text box to accept an answer. Based on the answer entered, the chat moves on to either prompt #5 (if the user answers 'New Zealand' or 'NZ') or prompt #6 (if the user answers anything else). Prompts 5 and 6 are not shown here. When matching answers, DialogForm can ignore case and whitespace if you wish.

&#x20;The "\*" is a special directive to DialogForm which means "*any answer other than the ones above"**.*** Scoring such prompts is very much like scoring multiple choice prompts. The correct and possibly any partially correct answers can be assigned scores as desired. The last answer ("\*") which basically means "*any answer other than the correct/partially correct ones*" can be assigned a zero score.

## **"Multi-Select" Multiple Choice Prompts**

### **What To Do**

Create a ["multi-select"](#multi-select-multiple-choice-prompts) prompt with answer options.

![](/files/vEJRq5Ewup2HhP0aphWB)

Note the red rectangle on the left. The "Allow multiple select" prompt setting is what makes a prompt a "multi-select" prompt. If you're not familiar with this yet, take a look at [this article](#multi-select-multiple-choice-prompts).

To add a score to the correct answer, hover on the <img src="/files/pqNJr08A79HGYJYGg73L" alt="" data-size="line"> icon that appears to the right of the answer, and select "Add Score" in the menu that opens up as a result.

You will see a<img src="/files/5Bj0EMsIWR4Q9W7ZGN57" alt="" data-size="line">pop up right above the answer. Click on it and customize your score <img src="/files/IXDdf5iKburBIjqMsXKh" alt="" data-size="line">. Negative numbers are fine too. To remove the score, just delete the value entered.

When your users respond with the options they think are correct, they will be awarded a score that is equal to the sum of the scores of the options they selected.

![Editor](/files/pSNNddakaU1XsIxSSRxo) ![Preview](/files/YdEc41xjMNVYUyBq0OXN)

## What Next?

What you saw above only scratches the surface of what DialogForm's scoring capabilities. Take a deeper dive into more advanced stuff.

{% content-ref url="/pages/SsinhQDd9TgO6XJMnx8Y" %}
[Advanced scoring](/user-guide/advanced-scoring.md)
{% endcontent-ref %}


---

# 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://docs.dialogform.in/user-guide/simple-scoring.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.
