# EMQs

EMQ (Extended Matching Questions) groups are a way to group questions together by a common stem.  Common uses for EMQs are:&#x20;

\
**Comprehension:** Using a large body of text that is shared across multiple questions to test comprehension

**Situational Judgement:** A shared situational based scenario with different questions attached

**Abstract Reasoning:** A common image or pattern shared across multiple different questions

**Instructions:** Use EMQs to provide instructions for certain types of questions ie (You should not use a calculator to work this out)

**Shared question information:** Share the same information across multiple questions, for maths questions this may be a shared formula, table or other information

{% hint style="info" %}
**🧠 Note:** EMQs on Synap will always be displayed together, even with shuffling enabled
{% endhint %}

## :link: Creating EMQ Groups

To support questions that ask users to read through a passage of text then answer multiple questions based on that text, use EMQs. We recommend that you make your EMQs before create the associated questions.&#x20;

{% embed url="<https://www.youtube.com/watch?index=3&list=PLkACRDV6xissR5bl2fk6QqE7RPNHXBl9R&v=5ZiBx7kAD4E>" %}
EMQs walkthrough
{% endembed %}

Navigate to the EMQ group page via the sub menu. From here use the editor to create the EMQ the same way you'd create a question. We recommend you give EMQ groups a unique and identifiable External ID as you'll need to be able to identify these groups when adding them to the questions.

![](/files/-MkkeOErH5yjPRA2wWJk)

### Adding EMQs to questions

Once your EMQs have been created you need to link them to the correct questions. In the individual question editor, scroll down to **Advanced options** from here use the drop down to select the EMQ group. You'll be shown the unique EMQ Synap ID as well as any external IDs you've created.

<figure><img src="/files/ykchkCWEu8odNHpr9SoX" alt=""><figcaption><p>Find the 'Placement' tab on an open question editor and select the EMQ group to add your question to</p></figcaption></figure>

Once you've done this you will see that the MCQ is 'wrapped' in a grey box containing the details of the EMQ.  Additional MCQs added to the same EMQ will be wrapped in the same box

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


---

# 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://academy.synap.ac/doc/quizzes/creating-a-quiz/emqs.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.
