# Domain Allowlisting

> Set the allowed domains for your Web SDK source, consent configuration, Session Replay, Experiments, and Translation widgets so Ours Privacy only runs on websites you own.

Source: https://docs.oursprivacy.com/docs/domain-allowlisting

Use this page to add the websites where Ours Privacy is allowed to run. Each product you install on a website has its own list of allowed domains, and Ours Privacy only loads or records data on the domains in that list.

[Open Install in app](https://app.oursprivacy.com/install)

> **Looking for the Event Allowlist?** That is a different feature that controls which event names are forwarded to destinations. See [Allowed Events](https://docs.oursprivacy.com/docs/allow-listing-events).

***

## Where to set allowed domains

Each product keeps its own list, and each Web SDK source has its own list too. A domain added to one Web SDK source does not carry over to another source, to your consent configuration, or to Session Replay. Add your domains everywhere you install Ours Privacy.

| Product                                                                  | Where to edit allowed domains                                                                                                      |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| [Web SDK](https://docs.oursprivacy.com/docs/web-sdk-javascript)          | [Sources](https://app.oursprivacy.com/sources), open your Web SDK source, then **Settings > Allowed Domains**                      |
| [Consent Management](https://docs.oursprivacy.com/docs/ours-privacy-cmp) | [Consent Settings](https://app.oursprivacy.com/marketing-center/consent-settings), open a configuration, then **General Settings** |
| [Session Replay](https://docs.oursprivacy.com/docs/session-replay)       | [Session Replay Settings](https://app.oursprivacy.com/session-replay/settings)                                                     |
| [Experiments](https://docs.oursprivacy.com/docs/experimentation)         | [Experiment Settings](https://app.oursprivacy.com/experiments/settings)                                                            |
| [Translation widget](https://docs.oursprivacy.com/docs/translate)        | [Translations](https://app.oursprivacy.com/marketing-center/translations), then open a widget                                      |

The [Install page](https://app.oursprivacy.com/install) lists your Web SDK sources, consent configurations, Session Replay, and Experiments in one place, flags any install that has no allowed domains, and lets you add domains to each one without leaving the page.

![The Allowed Domains editor on a Web SDK source with ourshealth.example and *.ourshealth.example allowed, matching tips, and a field to test a URL against the patterns](https://docs.oursprivacy.com/img/domain-allowlisting/domain-allowlisting-img-1.jpg)

***

## Add a domain

1. Open the settings page for the product from the table above.
2. In **Allowed Domains**, type your website's domain.
3. Click **Add Domain**. Repeat for each domain where the product runs.
4. Save your changes.
5. If the page shows **Unpublished Changes** in the header, click **Publish** so the new list goes live. See [Publishing changes](#publishing-changes).

***

## One Web SDK source per website

Allowed domains are set on each Web SDK source. If you run separate websites on different domains, such as a marketing site and a patient portal, consider creating a separate Web SDK source for each one. Each source then has its own allowed domains, along with its own mappings and destinations, so a change for one website doesn't affect the other.

If your websites share the same tracking setup, one source with every domain on its list works too.

***

## Check your list in the app

On a Web SDK source, use **Test a URL against your patterns** below the list to confirm whether a page on your website is covered before you publish.

A few habits keep your list accurate:

* **Add domains before you launch.** Add a new website's domain before you install the script so you don't miss data from the first visits.
* **Include the environments you test on.** Add staging or preview domains if you want Ours Privacy to run there, and remove them when you no longer need them.
* **Review the list when your websites change.** Remove domains you no longer own or use.

***

## Publishing changes

Allowed domains for your Web SDK sources, consent configurations, Session Replay, and Experiments go live when you [publish a version](https://docs.oursprivacy.com/docs/version-management). Changes saved from the Install page are added to your draft too, so publish after you finish editing. Translation widget domains take effect as soon as you save.

Every Web SDK source needs at least one allowed domain before you can publish. If a source has none, the publish screen suggests the domains where Ours Privacy has seen it installed and links to the source so you can add them.

***

## Troubleshooting

If Ours Privacy is installed on a site but nothing shows up:

* **Check the list for that product.** A domain on your Web SDK source does not allow Session Replay or your consent banner on that site.
* **Check that you published.** Look for **Unpublished Changes** in the dashboard header.
* **Check the right source.** If you have more than one Web SDK source, confirm the domain is on the source whose script is installed on that website.
* **Test the URL.** On a Web SDK source, paste the page's URL into **Test a URL against your patterns** to confirm it matches your list.
* **Allow for a short delay.** After you publish, it can take a few minutes for websites to pick up the new list.

***

## Next Steps

* [Install the Web SDK](https://docs.oursprivacy.com/docs/web-sdk-javascript) on your website
* [Set up the Ours Privacy consent banner](https://docs.oursprivacy.com/docs/ours-privacy-cmp)
* [Install Session Replay](https://docs.oursprivacy.com/docs/session-replay/installation)
* [Publish and manage versions](https://docs.oursprivacy.com/docs/version-management)
* [Control which events are forwarded with Allowed Events](https://docs.oursprivacy.com/docs/allow-listing-events)
