11. Domains

The Domains page lists the websites that are allowed to show your Reader Instances. A domain is the main part of a website address, such as www.example.com or reader.example.com.

Click Domains in the menu.

The list shows each Domain, its Description and when it was Created. If you have none yet, it says, "No domains have been added".

11.1 Add a domain

1. Click Add Domain.
   
2. In Permitted Domain Name, enter the web address without https:// or any path. For example, enter reader.example.com, not https://reader.example.com/books.
3. Optionally, add a Description (up to 500 characters), such as "Main online shop".
4. Click Add Domain.

Rules for domains:

• Subdomains must be added separately. example.com, www.example.com and shop.example.com are three different domains. Add each one that will show your Reader Embed.
• Wildcards are not accepted. You cannot enter *.example.com.
• If the address is not valid, you see "Enter a valid domain (e.g. reader.example.com)".

Then open each Reader Instance that should appear on this website and select the domain under Permitted Domains. See Details tab.

11.2 See which instances use a domain

Click a domain in the list to open its Properties panel:

• Details: the hostname (the web address), description and when it was created and last updated.
• Reader Instances: the instances that list this domain, with links to them. If none do, it says, "This domain is not used by any Reader Instances."

11.3 Edit or delete a domain

Open the domain's ⋮ menu:

• Edit: change the description. The web address itself cannot be changed ("The hostname cannot be changed after a domain has been created."). To use a different address, add a new domain.
• Delete: confirm "Are you sure you want to delete this domain? You will no longer be able to display publications on this domain."