> 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/help/troubleshooting.md).

# Troubleshooting

Fixes for the problems Yazi users hit most often, from sign-in and blank pages to failed broadcasts, missing media and mismatched numbers.

Find your problem below and open it for the likely cause and fix. If nothing here helps, see [Get help](https://docs.askyazi.com/help/get-help.md).

{% hint style="info" %}
**In short:** most problems have one of a few causes: the study is still in **Draft**, a WhatsApp rule (the 24-hour window, template approval or a messaging limit), a corporate network block, or test data being shown or hidden. Check those first.
{% endhint %}

## Accounts and the app

<details>

<summary>I cannot create a new project</summary>

If your organisation is on once-off billing, you can have **one active project at a time**. Finish or archive your current project, or ask your Yazi contact to set up the next one. Nothing is broken. See [Plans, billing and usage](https://docs.askyazi.com/start-here/plans-billing-and-usage.md#one-active-project-at-a-time-once-off-billing).

</details>

<details>

<summary>The page went blank after an update</summary>

When Yazi releases an update, a tab you had open from before can briefly fail to load. Yazi now reloads the page by itself once. If you still see a blank page or "Something went wrong loading this page", reload the tab yourself (or close it and open [app.askyazi.com](https://app.askyazi.com) again). If it keeps happening on a company laptop, your network may be blocking part of Yazi: see [Network allow-listing](https://docs.askyazi.com/set-up-whatsapp/network-allow-listing-for-corporate-it.md).

</details>

<details>

<summary>I can sign in but nothing loads</summary>

This is almost always a corporate network or VPN blocking one of the addresses the app uses, such as `chat-eu.askyazi.com` or Yazi's CloudFront addresses. Try mobile data to confirm, then ask IT to allow every domain in the first table of [Network allow-listing](https://docs.askyazi.com/set-up-whatsapp/network-allow-listing-for-corporate-it.md), exactly as written. If you were told to allow `app.askyazi.co`, that address does not exist: allow `app.askyazi.com` instead.

</details>

<details>

<summary>My verification or sign-in code is not arriving</summary>

Company email systems often hold these codes for a few minutes, or put them in quarantine. Wait a few minutes, check spam and quarantine, and ask IT to let Yazi's emails through. If you were invited by a colleague, ask your Yazi contact for a direct join link. Signing in with Google or Microsoft avoids Yazi's emailed code altogether. See [Accounts and sign-in](https://docs.askyazi.com/start-here/accounts-and-sign-in.md#if-a-code-does-not-arrive).

</details>

<details>

<summary>My colleague signed up but cannot see any of our studies</summary>

They have most likely created a new organisation instead of joining yours. Ask Yazi support to move them into your organisation, and next time send an invite from **Settings** > **Members** > **Invite members**, or share the access code from **Settings** > **Organisation**. See [Accounts and sign-in](https://docs.askyazi.com/start-here/accounts-and-sign-in.md#join-an-existing-organisation).

</details>

<details>

<summary>The Dashboard shows no studies</summary>

Refresh the page. If studies are still missing, check you are in the right organisation using the organisation switcher at the bottom of the left navigation, and check no filter is applied on the Dashboard.

</details>

## Studies and testing

<details>

<summary>The study link does nothing, or WhatsApp says the study is not available</summary>

Check these in order:

1. **Status.** A **Draft** study cannot be taken by anyone. Move it to **Testing** to try it, or **Live** for participants. A paused or closed study tells people so. [Publish and go live](https://docs.askyazi.com/study-types/publish-and-go-live.md)
2. **Unpublished changes.** If the status pill says the study has changes that are not published, publish them.
3. **The starter message.** The participant must send the pre-typed message (for example "Send to start #4F9A1") exactly as it appears. If they edited or deleted it, ask them to open the link again.
4. **The right link.** Use the test link for testing and the live link for participants.
5. **WhatsApp on the phone.** The participant needs WhatsApp installed on that phone. WhatsApp Flow questions only open in the WhatsApp phone app, not on WhatsApp Desktop or Web.

</details>

<details>

<summary>A participant says "I'm told I'm not enrolled" or "I've already completed this"</summary>

"Not enrolled" usually means they messaged the number without a study code, or their starter message was changed. Ask them to tap the study link or the latest invite again. "Already completed" means that number has already finished the study; people cannot retake a study unless you allow it. If this happens after you deleted your own test answers, open the test link again; if it persists, contact support.

</details>

<details>

<summary>The Flow-based survey option is greyed out</summary>

Flows cannot show every question type. **Flow-based survey** (in **Study configuration** > **Participant experience**) greys out if the study contains a **Voice Note**, **Video** or **Location** question, or another type Flows cannot render. Hover over the option to see why. Flows also need your WhatsApp number to be approved for them, which usually means business verification. You can mix modes in a multi-activity study: use Flows where you can and in-chat for activities that need voice notes. See [In-chat vs WhatsApp Flows](https://docs.askyazi.com/build-a-study/in-chat-vs-whatsapp-flows.md) and [Business verification](https://docs.askyazi.com/set-up-whatsapp/business-verification.md).

</details>

<details>

<summary>A matrix or multi-select question never arrives on the participant's phone</summary>

Some question types reach participants as WhatsApp forms, which only work when your WhatsApp account is fully verified and in good standing with Meta. The **Build** tab shows a warning naming the affected questions. Verify your business, or use a simpler question type until you have. See [Business verification](https://docs.askyazi.com/set-up-whatsapp/business-verification.md).

</details>

<details>

<summary>My answer options look cut off, or show "Option 1, Option 2"</summary>

WhatsApp limits how long button and list labels can be. Long options are shortened or replaced with generic labels. Keep options short. See [WhatsApp limits](https://docs.askyazi.com/build-a-study/whatsapp-limits.md).

</details>

## Broadcasts, templates and reminders

<details>

<summary>My template was rejected, or creating it gave an error</summary>

* **Error straight away (often a "400"):** template names can only use lower-case letters and underscores. "Spring Survey Invite" fails; `spring_survey_invite` works.
* **Rejected by Meta after review:** Meta may have judged the wording promotional or against its commerce rules. Reword it to say plainly who you are and what the study is, remove sales language, and submit again.
* **Approved as a different category:** Meta decides whether a template is marketing or utility. An invite that mentions an incentive is usually marketing. To dispute a category, appeal in Meta Business Manager, not in Yazi.

See [Broadcast templates](https://docs.askyazi.com/reach-participants/broadcast-templates.md).

</details>

<details>

<summary>My broadcast failed for some people</summary>

Open the broadcast in **Send History** (or the participant's panel on the **Share** tab) to see the reason for each person in plain English. Common causes:

* **The number is not on WhatsApp**, or WhatsApp is not installed. Retrying will not help; share the link another way.
* **No country code.** Numbers need their country code. If a number was entered in local format (starting with 0), Yazi asks which country it belongs to.
* **The person has turned off marketing messages** in WhatsApp. A utility template or a direct link may reach them.
* **You hit your daily messaging limit.** WhatsApp rejects sends over the limit. Verify your business and send in batches. [Number health and limits](https://docs.askyazi.com/set-up-whatsapp/number-health-and-limits.md)
* **No payment method in Meta**, or a declined card. [Add a payment method](https://docs.askyazi.com/set-up-whatsapp/add-a-payment-method-in-meta.md)

"Accepted by WhatsApp" means WhatsApp took the message; it does not yet mean it was delivered or read. See [Send history and statuses](https://docs.askyazi.com/reach-participants/send-history-and-statuses.md).

</details>

<details>

<summary>My reminder template does not appear in the list</summary>

Reminders need an approved template with both a **Continue** button and an **Opt-out** button. Templates without them are hidden, and the Reminders list says how many it is hiding and why. Check the template is approved (Meta approval can take from minutes to a day) and is in the participant's language: each language needs its own approved template. See [Reminders](https://docs.askyazi.com/reach-participants/reminders.md).

</details>

<details>

<summary>The chat shows "Out of 24hr" and I cannot message the participant</summary>

WhatsApp only allows free-text messages within 24 hours of the participant's last message. After that, use the **Request to chat** card in the takeover screen: it sends an approved message with **Accept** and **Opt out** buttons, and you can chat once they accept. See [Agent takeover](https://docs.askyazi.com/monitor-fieldwork/agent-takeover.md).

</details>

## Media and transcription

<details>

<summary>A voice note was not transcribed</summary>

* **Language.** Yazi transcribes the languages set up on the study. Some languages cannot be transcribed today, including isiXhosa, Sesotho, Setswana, Xitsonga, Tshivenda, siSwati, isiNdebele and Sepedi. See [Language support](https://docs.askyazi.com/study-types/language-support.md).
* **Very short or silent clips** may produce no text.
* **A failed transcription stays empty** rather than being sent to another service outside Yazi's region.
* **Word-by-word highlighting** only works on voice notes recorded from 7 October 2026; older ones show a plain transcript.

</details>

<details>

<summary>Photos, videos or voice notes are missing from the Media Library</summary>

Click **Refresh** at the top right of the Media Library (or **Check for new media** on an empty library) to pull in anything that arrived since you opened the page. Also check:

* **Test data.** If the media came from a test, switch on the test-data chip.
* **Round video messages.** WhatsApp's round "instant video" messages never reach Yazi. The participant is asked to send the video another way.
* **File size.** WhatsApp limits images to 5 MB and video and audio to 16 MB.
* **Filters.** Clear any filters in the library.

</details>

## Results and exports

<details>

<summary>The numbers in Table Data, Graph Data and my export do not match</summary>

* **Test data.** The test-data chip decides whether test responses are counted. Make sure it is set the same way on each screen.
* **The table shows a window, the export has everything.** Table Data loads rows as you scroll, but exports always contain every respondent that matches your filter. Trust the export for totals.
* **Different definitions.** "Started" means answered at least one question. "Completed" means reached the end. Screened-out people count as neither.
* **Filters.** Check for filters on the table, and which status you chose when exporting (for example **Completed Only** or **Completed + In Progress**).
* **Trust exclusions.** If **Auto-exclude rejected responses** is on, rejected participants are left out of analytics.

See [Exports](https://docs.askyazi.com/results-and-reporting/exports.md).

</details>

<details>

<summary>AI interview follow-up questions are not in Graph Data</summary>

That is by design. Every AI follow-up is unique to the participant, so Graph Data only charts your fixed questions. Read follow-ups in **Responses** > **Transcripts**, or use **Insights** for themes. See [Transcripts](https://docs.askyazi.com/results-and-reporting/transcripts.md).

</details>

## Related

* [What Yazi cannot do (yet)](https://docs.askyazi.com/help/what-yazi-cannot-do-yet.md)
* [Get help](https://docs.askyazi.com/help/get-help.md)
* [Network allow-listing](https://docs.askyazi.com/set-up-whatsapp/network-allow-listing-for-corporate-it.md)
* [Number health and limits](https://docs.askyazi.com/set-up-whatsapp/number-health-and-limits.md)
