> 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/start-here/getting-around-the-app.md).

# Getting around the app

A tour of the Yazi web app, from the left navigation and Dashboard to the four tabs inside every study and the Settings pages.

This page is a map of the Yazi web app. Use it to find where something lives; each section links to the page that explains it in full.

{% hint style="info" %}
**In short:** the left navigation takes you to the **Dashboard** (your studies), **Broadcast Messages**, **Scheduled Messages**, **People**, **Settings** and **Feedback & Support**. Inside a study, everything sits under four tabs: **Build**, **Share**, **Responses** and **Reporting**. **Ask Yazi** is always available from the right edge of the screen.
{% endhint %}

## The left navigation

| Item                   | What you do there                                                                                                                                                                                      |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Dashboard**          | See all your studies, search and filter them, and start a new one.                                                                                                                                     |
| **Broadcast Messages** | Create WhatsApp message templates, check their Meta approval status and see what you have sent. [Broadcast templates](https://docs.askyazi.com/reach-participants/broadcast-templates.md)              |
| **Scheduled Messages** | Set up reminders, messages fired by your own systems, and broadcasts sent from an uploaded list on a schedule. [Scheduled Messages](https://docs.askyazi.com/reach-participants/scheduled-messages.md) |
| **People**             | Your contacts and past participants, with their details and history. [People and contacts](https://docs.askyazi.com/reach-participants/people-and-contacts.md)                                         |
| **Settings**           | Organisation details, billing, branding, themes, AI settings, integrations, API keys, members and audit logs. See [Settings](#settings) below.                                                         |
| **Feedback & Support** | Send a message (and a screenshot) to the Yazi team. [Get help](https://docs.askyazi.com/help/get-help.md)                                                                                              |

At the bottom of the navigation you will find:

* The **WhatsApp Number Quality** widget, showing the number your organisation sends from and its current quality rating (for example "Green"). It refreshes every 5 minutes. [Number health and limits](https://docs.askyazi.com/set-up-whatsapp/number-health-and-limits.md)
* Your profile and the organisation switcher, if you belong to more than one organisation.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2Fi6K1X20IW7Fmyx89YYGu%2Fwhatsapp-quality-widget.webp?alt=media&amp;token=8fb825e2-d674-476a-bd45-ccb34ca6dbd9" alt="The WhatsApp Number Quality widget at the bottom of the left-hand menu, showing the number&#x27;s quality as Green"><figcaption></figcaption></figure>

## The Dashboard

The Dashboard lists every study in your organisation in one table, with these columns: **Title**, **Started**, **Completions**, **Completion Rate**, **Type**, **Status**, **Actions** and **Created**.

* **Type** shows what kind of study it is: **Survey**, **Interview**, **Recurring Survey**, **Live Form** or **Study** (a multi-activity study, with "N activities" under its title).
* **Status** shows **Draft**, **Live** and the other study states.
* Use the search box to find a study by anything visible in its row, including dates, and **+ Add Filter** to narrow the list. The table scrolls rather than paging. Drag a column edge to widen it; Yazi remembers the width.
* **+ New Research** (top right) opens the **Create Research** screen, where you choose **Build with AI** (upload or paste a brief) or **Build manually**. [Create a study](https://docs.askyazi.com/build-a-study/create-a-study.md)

A brand new organisation sees a single card explaining the four steps (choose a method, write your questions, send on WhatsApp, read the results) with a **Create Your First Study** button. New organisations also get demo studies with sample answers to explore.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FT4q2bPn34ebblEDqB91r%2Ffs-dashboard-new-research.webp?alt=media&amp;token=81592bc8-7a10-4419-b3b6-d6db888f79dc" alt="The Dashboard listing your studies, with New Research at the top right"><figcaption></figcaption></figure>

## Inside a study

Open any study from the Dashboard. The top bar shows:

* A **type chip** on the left (for example "Interview"), with a dropdown to convert the study to another type before it goes out to people.
* The study title.
* The four tabs: **Build | Share | Responses | Reporting**.
* The **status** pill (for example "Live"). A Draft study shows a **Move to testing** button here instead; a study in Testing is moved to Live from the same place. [Publish and go live](https://docs.askyazi.com/study-types/publish-and-go-live.md)
* **Manage study**, a menu of study-level actions. On a live study it offers **Transition to Testing** (pull it back to keep working on it), **Pause** (stop accepting responses for now) and **Close** (close it to new responses).
* A clock icon for version history, where you can see earlier versions of the study.

The web address still contains `/campaigns/...`. That is an older name for a study.

### Build

Where you write and configure the study.

* Questions are listed in order, each with its number, text and type (for example **Statement**, **Text**, **Single Select**, **Number**). Icons on each question let you add logic, set routing, open settings, preview it as a participant would see it (the eye icon), duplicate it or delete it. Use **+** between questions to insert one.
* An AI interview has two sub-tabs: **Survey questions** and **Interview configuration**.
* Click a question to edit it: the text box (up to 500 characters) has **Add Emoji**, **Improve** (AI rewording) and **Add Media**, and the question type is chosen from a dropdown on the right.
* Top-right actions: **Logic Map** (a visual map of your routing), **Test** (opens the **Test Simulator** panel, a phone preview of the chat with **Run Simulation** and **Reset**) and **Export** (download the questionnaire).
* The **Study configuration** panel on the right has a **Settings** tab and a **Blocks** tab, plus a "Search settings" box. Settings are grouped as:

| Setting                     | What it controls                                                                                                                                                                                                                                                                                                                                        |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Participant experience**  | **Builder Mode** (how questions reach participants: **In-chat survey**, **Flow-based survey** or, where it is switched on for your organisation, **Live Form**), **Campaign Language** (the language of system messages), **Translate responses into** (the language you read results in), **Multi-Language Support** and **Hide Question Percentage**. |
| **Completion & follow-up**  | What happens at the end: whether to **Send a completion message**, its wording, and an optional button. Under **Advanced options** you can send a **Closing broadcast** instead, **Redirect to another survey**, or **Give a reward** (a voucher or code on completion).                                                                                |
| **Quota**                   | The **Completion target** and caps per answer on chosen single-select questions, with **Inputs** and **Tracking** tabs.                                                                                                                                                                                                                                 |
| **Response quality**        | **Response Trust** and its **Sensitivity** (Lenient, Balanced or Strict), **Auto-exclude rejected responses**, and **Enable Question Actions** (AI checks on media answers). The row shows, for example, "Trust · Balanced".                                                                                                                            |
| **Privacy & screening**     | **Privacy Protection** (hides participants' identities), the **Screen-Out Message** and the **Repeat Attempt Message**.                                                                                                                                                                                                                                 |
| **Integrations** (Advanced) | **Response Push**: sending responses to your own system by webhook. Shows "No webhook" when off.                                                                                                                                                                                                                                                        |

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FYmiAFD5ztRRNQzV2g7MI%2Fstudy-configuration-panel.webp?alt=media&amp;token=a51d02a6-c258-48cc-9339-21303bd1138c" alt="The Study configuration panel on the Build tab, listing Participant experience, Completion &#x26; follow-up, Quota, Response quality, Privacy &#x26; screening and the Advanced settings"><figcaption></figcaption></figure>

### Share

Where you invite people and watch fieldwork.

* Sub-tabs: **Participants** and **Panel Recruitment**.
* Top-right actions: **Test**, **Share link**, **Add People**, **View broadcast history**, **Reminders** and **Send broadcast**.
* A funnel shows how many people were sent the invite, received it, started and completed (an interview also shows survey done and interview started).
* The participant table shows each person's source, status, trust verdict and reason, progress, reminders and last activity, with filters (All, Delivered, In survey, Survey done, Completed) and an export.

See [Participants tab](https://docs.askyazi.com/monitor-fieldwork/participants-tab.md) and [Ways to invite participants](https://docs.askyazi.com/reach-participants/ways-to-invite-participants.md).

### Responses

The raw results.

* Sub-tabs: **Table Data** (one row per participant), **Media Library** (photos, videos and voice notes) and **Transcripts** (each participant's full WhatsApp conversation, where you can also take over a chat).
* A test-data chip (for example "20 test") shows or hides test responses.
* **Export** downloads the data.

See [Results overview](https://docs.askyazi.com/results-and-reporting/where-your-results-live.md).

### Reporting

The analysed results.

* Sub-tabs: **Graph Data** (a chart and AI analysis per question, with **Cross-tab** and **PPT** export), **Reels** (video highlight reels), **Insights** (themes and categories) and **Report** (a generated written report).
* The same test-data chip as Responses.

## Ask Yazi

**Ask Yazi** is the AI assistant built into the app. When you open a screen it introduces itself briefly, then tucks away as a small tab on the right edge. Hover over the tab to bring it out and click to open the chat. Inside the chat, **Minimise** sends it back. Ask Yazi knows which screen you are on, so you can ask it to change the study in front of you. [Ask Yazi](https://docs.askyazi.com/build-a-study/ask-yazi.md)

## Settings

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FvJ6bu9cuHgnivWV4i7tW%2Ffs-settings-organisation.webp?alt=media&amp;token=285760cd-09a2-4bbc-b898-a0f2ccf2210a" alt="Settings > Organisation: organisation name and access code, the optional menu campaign and incentive credits. The Settings list on the left holds every other settings page."><figcaption></figcaption></figure>

| Section          | What is there                                                                                                                                                                                                                                                                                        |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Organisation** | Your organisation's name; the **Access Code** colleagues use to join; **Menu Campaign** (an optional study that acts as the main menu when someone messages your WhatsApp number without a study code); and **Incentive Credits** (your reward balance, **Request Credits** and request history).    |
| **Plan & Usage** | Your current plan and this period's usage: billing mode, tier, bundle balance, projects and completed activities, plus the list of projects. Rates are assigned by Yazi, in your organisation's currency. [Plans, billing and usage](https://docs.askyazi.com/start-here/plans-billing-and-usage.md) |
| **Branding**     | **Organisation Logo**: your logo, shown in various places across the platform.                                                                                                                                                                                                                       |
| **Appearance**   | Themes for the app: four light themes, five dark themes, or **System** to follow your device. Your choice is saved to your account and follows you to any browser.                                                                                                                                   |
| **AI Settings**  | The **Interview Prompt** that sets the tone and behaviour of every AI interview in your organisation. [AI interviews](https://docs.askyazi.com/study-types/ai-interviews.md)                                                                                                                         |
| **Integrations** | Connect Claude or ChatGPT to ask questions about your studies in plain English (read only by default), and Google Sheets or Microsoft Excel live exports. [AI assistants](https://docs.askyazi.com/integrations-and-api/connect-claude-or-chatgpt.md)                                                |
| **API Keys**     | Keys for the Connect Gateway API, so your own systems can trigger Yazi messages. **Create New Key** limits a key to the endpoints you choose. The key value is shown only once, when you create it. [Event triggers API](https://docs.askyazi.com/integrations-and-api/event-triggers-api.md)        |
| **Members**      | Everyone in your organisation with their role (**Admin** or **Member**), pending invites, and **Invite members**. [Accounts and sign-in](https://docs.askyazi.com/start-here/accounts-and-sign-in.md)                                                                                                |
| **Audit Logs**   | A record of changes made in your organisation: who changed what, and when.                                                                                                                                                                                                                           |

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FbZvSDGgTZvZLXl1pqDRE%2Fsettings-integrations-connectors.webp?alt=media&amp;token=aa490faf-f4e5-40c6-8c83-6f220ba2cc24" alt="Settings, Integrations, Connectors with the MCP server URL and the set-up steps for claude.ai"><figcaption></figcaption></figure>

## Notices and banners

* **Toasts** (small messages, bottom right) confirm actions such as saves and exports. A new incoming WhatsApp message also arrives as a toast with a **View chat** button.
* An **account banner** across the top of the app warns you if your WhatsApp account has a problem, such as a billing block, a restriction or a low quality rating. [Number health and limits](https://docs.askyazi.com/set-up-whatsapp/number-health-and-limits.md)
* A banner inside a study tells you if participants are stuck. You can dismiss it; it comes back only if the number grows.

## Using Yazi on a phone

The web app works on a phone. Pop-ups open as sheets from the bottom, results show as one card per participant, and tables stack into a list. Building a long questionnaire is still easier on a computer.

## Limits and things to know

* **"Campaign" still appears in a few places**, such as web addresses and the **Menu Campaign** setting. It means study.
* **Side panels open at half the screen width.** Drag the edge to make one wider; Yazi remembers your width. Close any panel with its close button, by clicking outside it or with Escape.
* **Some screens differ by study type.** For example, **Interview configuration** only appears on AI interviews.

## Related

* [Key concepts and glossary](https://docs.askyazi.com/start-here/key-concepts-and-glossary.md)
* [Quickstart: your first study](https://docs.askyazi.com/start-here/quickstart-your-first-study.md)
* [Accounts and sign-in](https://docs.askyazi.com/start-here/accounts-and-sign-in.md)
* [Plans, billing and usage](https://docs.askyazi.com/start-here/plans-billing-and-usage.md)
