> For the complete documentation index, see [llms.txt](https://docs.askyazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.askyazi.com/build-a-study/create-a-study.md).

# Create a study

Create a new study with AI from a brief or questionnaire, from an example template, or from scratch, and know what to check before you publish.

Every study starts from the **+ New Research** button at the top right of the Dashboard. You can let Yazi build a first draft from a document you already have, or build the study yourself question by question. Both routes end in the same builder, where you can edit everything.

{% hint style="info" %}
**In short:** **Build with AI** turns a brief or questionnaire (PDF, DOC, DOCX, XLSX or TXT, up to 10 MB) into a draft study in a few minutes. **Build manually** gives you an empty study of the type you pick. AI drafts are a starting point: proofread every imported question against your source, because the AI sometimes rewords questions.
{% endhint %}

## Before you start

* You need a Yazi account and to be a member of your organisation. If a colleague already uses Yazi, join their organisation with its access code rather than creating a new one. See [Accounts and sign-in](https://docs.askyazi.com/start-here/accounts-and-sign-in.md).
* Decide on the method first. See [Choose a study type](https://docs.askyazi.com/build-a-study/choose-a-study-type.md).
* You can build and test without a connected WhatsApp number. You only need a number when you invite real participants.

## Build with AI

Use this when you already have a research brief, a discussion guide or a written questionnaire.

{% stepper %}
{% step %}

### Open Create Research

Click **+ New Research**. On the **Create Research** screen ("Tell us about your research"), choose **Build with AI**.
{% endstep %}

{% step %}

### Add your brief

Choose **Upload File** and drag your document into the drop zone ("Drag and drop your brief here"), or choose **Paste Text** and paste it in. Accepted files are PDF, DOC, DOCX, XLSX or TXT, up to 10 MB.

Not sure how to lay out a brief? The screen offers example templates to download: **Survey**, **AI Interview** or **Multi-activity study**. Filling one in gives the AI the structure it reads best.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2Fs6WgKh49r3TUTA5NXHah%2Ffs-create-research-ai.webp?alt=media&amp;token=f211b83a-714d-48a7-bab6-d4f98596e293" alt="Create Research with Build with AI selected: upload a brief or paste text"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Continue to analysis

Click **Continue to analysis**. Yazi reads the document and proposes a study: the method, the activities, the questions and answer options, the routing, the languages and, for an interview, the interview configuration. This usually takes a few minutes.
{% endstep %}

{% step %}

### Review the proposal

Read the proposal card. If something is wrong, type what to change in the box at the bottom (for example "make Q4 a multi-select" or "this should be one activity, not three") and Yazi updates the proposal. When it looks right, create the study.
{% endstep %}

{% step %}

### Check the draft in the builder

The study opens on the **Build** tab. Work through the checklist in [What to check after an AI build](#what-to-check-after-an-ai-build) before you test.
{% endstep %}
{% endstepper %}

### What the AI carries across from your document

* Questions, answer options and question types, including matrix (rating grid) questions.
* Screen-outs, skips and piped answers written in the brief. A rule such as "Ask Q19 only if Q12 = Yes" becomes an **Only show if** condition on Q19.
* The languages your brief names. A brief that asks for English, isiZulu and Kiswahili produces a study with those three languages switched on.
* For AI interviews: research objectives, target audience, key topics and required questions.
* Response Trust (automatic quality scoring) is switched on for studies created with AI.

### How to prepare a Word questionnaire

If you are uploading a signed-off questionnaire rather than a brief, a little preparation saves a lot of fixing:

1. **Remove section headers.** The AI can read a heading such as "Section B: Usage" as the start of a separate activity, which turns one survey into a multi-activity study.
2. **Number the questions in one sequence** (Q1, Q2, Q3 ... to the end), not per section.
3. **Write each question on its own**, with its answer options listed underneath. Avoid combining several prompts in one line ("Tell us X, Y and Z").
4. **Write routing in plain words next to the question it affects**, for example "If No, screen out" or "Ask only if Q3 = Daily".
5. **Keep answer options short.** WhatsApp limits option length. See [WhatsApp limits](https://docs.askyazi.com/build-a-study/whatsapp-limits.md).

### What to check after an AI build

{% hint style="warning" %}
**The AI does not always copy wording exactly.** In testing, roughly one question in five came back reworded, with the meaning kept but the wording changed. If your questionnaire is signed off, compare every imported question and option against the source before you publish.
{% endhint %}

* **Wording**: proofread every question and option against your document.
* **Structure**: check you got one activity if you wanted one. If the AI split your survey into several activities, ask it to rebuild the proposal as one activity before you create the study.
* **Question types**: check each type, especially multi-select versus single select, and that rating grids came through as matrix questions.
* **Logic**: open the **Logic Map** and walk every route. See [Logic and routing](https://docs.askyazi.com/build-a-study/logic-and-routing.md).
* **Limits**: fix anything the builder flags in red, such as options that are too long or too many rows in a matrix.
* **Languages**: check translations in each language, or export them for a reviewer.
* **Test it**: run the study in the Test Simulator and on your own phone. See [Test your study](https://docs.askyazi.com/study-types/test-your-study.md).

## Build manually

Use this when you want full control from the first question, or when the study is short.

{% stepper %}
{% step %}

### Choose Build manually

Click **+ New Research**, then **Build manually**.
{% endstep %}

{% step %}

### Pick the study type

Under **STUDY TYPE**, choose **Single campaign** (one activity) or **Multi-activity** (two or more activities).

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FpFAihO6xAzu2X4HSiAc2%2Ffs-create-research-manual.webp?alt=media&amp;token=61cb939a-dbf3-4bf6-8ec0-8ad8e18b762b" alt="Create Research with Build manually selected, showing the study type and research method choices"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Pick the research method

Under **RESEARCH METHOD**, choose **Survey**, **Interview**, **Recurring** or **Group Discussion**. Group Discussion is early access. See [Group discussions](https://docs.askyazi.com/study-types/group-discussions.md).
{% endstep %}

{% step %}

### Continue to the builder

Click **Continue**. Nothing is generated for you in manual mode: you add questions on the next screen with the **+** buttons between questions.
{% endstep %}
{% endstepper %}

For an AI interview, the **Interview configuration** sub-tab also offers ready-made interview briefs. Open **Research objectives** and click **Browse all templates** to start from a brief instead of a blank box. See [AI-moderated interviews](https://docs.askyazi.com/study-types/ai-interviews.md).

## Start from an earlier study

To reuse a study you have run before, duplicate it rather than building it again. The copy includes questions, options, logic, piping and translations, and starts as a draft with no responses. Duplicating a single activity inside a multi-activity study is also possible.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FTPDGVh7oGcfHzTT9m2vP%2Ffs-duplicate-study.webp?alt=media&amp;token=a64c75a2-ce2d-456f-ad53-ad1bbecba799" alt="Duplicating a study from the Dashboard: give the copy a new title, then click Duplicate Campaign"><figcaption></figcaption></figure>

## Rename or change the type of a study

* **Rename**: click the study title at the top of the study and type a new name.
* **Change the type**: use the type chip at the top left of the study (for example "Survey" with a dropdown), or ask Ask Yazi to convert it. Yazi keeps the questions and any responses and shows what the change means before applying it. A study that has already gone out to participants cannot be converted.

## Limits and things to know

* **AI drafts need human review.** Wording can change, and you should always check logic and structure before publishing.
* **Files up to 10 MB** in PDF, DOC, DOCX, XLSX or TXT.
* **Section headers can create extra activities.** Remove them from Word questionnaires before uploading.
* **Check the structure before you create the study.** Fixing a split into several activities is much easier at the proposal stage than afterwards.
* **Studies that have gone out cannot change type.** Duplicate and convert the copy instead.
* **Building is free; fielding is billed.** You can create and test studies without being charged. See [Plans, billing and usage](https://docs.askyazi.com/start-here/plans-billing-and-usage.md).

## Related

* [Choose a study type](https://docs.askyazi.com/build-a-study/choose-a-study-type.md)
* [Ask Yazi](https://docs.askyazi.com/build-a-study/ask-yazi.md)
* [Question types](https://docs.askyazi.com/build-a-study/question-types.md)
* [Logic and routing](https://docs.askyazi.com/build-a-study/logic-and-routing.md)
* [Test your study](https://docs.askyazi.com/study-types/test-your-study.md)
* [Publish and go live](https://docs.askyazi.com/study-types/publish-and-go-live.md)
