> 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/set-up-whatsapp/network-allow-listing-for-corporate-it.md).

# Network allow-listing for corporate IT

The domains your corporate IT team needs to allow so Yazi works on your network and VPN, and how to recognise a network block.

Some company networks, VPNs and managed laptops block websites they do not recognise. Yazi uses more than one web address, so allowing only the main one is a common reason the app loads partly or not at all. Share this page with your IT team before your first study.

{% hint style="info" %}
**In short:** for the web app, allow `app.askyazi.com`, `chat-eu.askyazi.com` and Yazi's two Amazon CloudFront addresses, plus `links.askyazi.co` for media and export links. Add the other addresses below only if your team uses those features. Some Yazi addresses end in `.com` and some in `.co`: enter them exactly as written. Allow-listing is necessary but not always enough, because a VPN gateway policy can still block traffic, so test from the network your team will actually use.
{% endhint %}

## Domains to allow

### Needed by everyone using the Yazi web app

| Domain                         | Used for                                                                  |
| ------------------------------ | ------------------------------------------------------------------------- |
| `app.askyazi.com`              | The Yazi web app, and the API it talks to (under `app.askyazi.com/api/`). |
| `chat-eu.askyazi.com`          | **Ask Yazi**, the assistant inside the app.                               |
| `d2holusqk9h90.cloudfront.net` | App files and media, served through Amazon CloudFront.                    |
| `ddwl4m2hdecbv.cloudfront.net` | App files and media, served through Amazon CloudFront.                    |
| `links.askyazi.co`             | Short secure links to media, voice notes and export downloads.            |

If your policy allows wildcards, `*.cloudfront.net` covers both CloudFront addresses.

If media or export links still do not open after you allow `links.askyazi.co`, contact Yazi and we will confirm the storage address your network also needs.

### Needed only for some features

| Domain                                 | Used for                                                                                                                                                                       | Who needs it                                                                    |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| `mcp.askyazi.co`                       | The connector for Claude and ChatGPT. [AI assistants](https://docs.askyazi.com/integrations-and-api/connect-claude-or-chatgpt.md)                                              | Anyone connecting an AI assistant.                                              |
| `api.askyazi.co` and `api.askyazi.com` | Yazi's developer API, for your own systems sending Yazi messages or reading results. [Event triggers API](https://docs.askyazi.com/integrations-and-api/event-triggers-api.md) | Developers and servers calling the API. The web app itself does not need these. |
| `forms.askyazi.co`                     | Live Forms, the web-form version of a study. [Live Forms](https://docs.askyazi.com/study-types/live-forms.md)                                                                  | Participants answering a Live Form from a company network or device.            |
| `docs.askyazi.com`                     | This documentation.                                                                                                                                                            | Optional.                                                                       |

If your team signs in with Google or Microsoft, those sign-in pages must also be reachable. The app also loads optional analytics services; blocking them does not stop Yazi working.

{% hint style="warning" %}
**`app.askyazi.co` is not a Yazi address.** It does not exist, so allowing it does nothing. If you were told earlier to allow `app.askyazi.co`, that advice was wrong: allow the domains in the tables above instead, and check that `app.askyazi.com` (with `.com`) is on your list.
{% endhint %}

Ask IT to enter every domain exactly as written. Someone "correcting" a `.co` to `.com`, or the other way round, is a common mistake.

## How to tell your network is blocking Yazi

* Your browser shows **ERR\_NAME\_NOT\_RESOLVED** or a similar "cannot reach this site" error.
* You can sign in, but the Dashboard stays blank or keeps loading.
* Some screens work and others fail, for example "Failed to add contacts", or **Ask Yazi** will not open.
* Yazi works on your phone's mobile data or at home, but not in the office or on the VPN.
* Access works for a while, then stops again after a VPN or security policy update.

If access comes and goes with no change on your side, the cause is almost always a network or VPN policy.

## What to do

{% stepper %}
{% step %}

### Confirm it is the network

Try Yazi on a phone using mobile data, or on a home connection. If it works there, your corporate network is the cause.
{% endstep %}

{% step %}

### Send IT the domain list

Share the tables above. Ask them to check that every domain in the first table is allowed, exactly as written.
{% endstep %}

{% step %}

### Check the VPN separately

Allow-listing on the office network does not always carry over to the VPN. Ask IT to check the VPN gateway policy too, and test again on the VPN.
{% endstep %}

{% step %}

### Get Yazi on a call with IT

If it still fails, contact Yazi support. We can join a call with your IT team to trace what is being blocked.
{% endstep %}
{% endstepper %}

### Workarounds while IT fixes it

* Connect to the internal company network directly instead of through the VPN.
* Use another device that is not managed by your company's security software, if your policy allows.
* Ask a colleague whose access works to make urgent changes, such as pausing a study.

## Limits and things to know

* **Allow-listing is necessary but not always enough.** VPN gateways and security tools can block traffic even when a domain is on the list.
* **Offices sharing one internet address:** Yazi limits how many requests one address can make in a short time, to protect the service. The limit is high (5,000 requests per 5 minutes per address), but a large team on one address could briefly hit it. Contact support if your whole office is locked out at once.
* **Participants are not affected by your network.** They take part in WhatsApp on their own phones. Only participants answering a Live Form on a company network need `forms.askyazi.co`.
* **Plan this before launch.** A blocked network found on launch day can cost days of fieldwork. Add the domain list to your onboarding checklist.

## Related

* [Accounts and sign-in](https://docs.askyazi.com/start-here/accounts-and-sign-in.md)
* [Troubleshooting](https://docs.askyazi.com/help/troubleshooting.md)
* [Security overview](https://docs.askyazi.com/security-and-privacy/security-overview.md)
* [Get help](https://docs.askyazi.com/help/get-help.md)
