The Domain Management tool in Web provides self-service domain management, eliminating the need for manual support requests.

Feature Overview

• Visibility: Quickly access and review all configured domains in one centralized list, ensuring full control and reducing the risk of misconfigurations.
• Efficiency: Make changes without waiting for approvals or manual updates, improving operational speed and flexibility. 

Please note: Changes may take several minutes to update.

• Scalability: Whether you're managing a single domain or multiple, this tool allows seamless modifications, making it easy to adapt as your business evolves. 

How to Access Domain Management

1. Log in to your Optimove instance.
2. Navigate to Settings > Web 
3. Click on the Domain Management Tab

Managing Your Domains

Adding a New Domain

1. Click Add Domain.
2. Enter the domain name.
3. Click Add Domain to apply changes.

Please Note: Domains must be correctly formatted (e.g., example.com or sub.example.com). 

Deleting a Domain

You can manually delete domains that are no longer in use by:

1. Clicking on the Trash Can beside the domain
2. Select Delete domain from the confirmation prompt

Please Note: Deleted domains cannot be recovered; you will need to re-add them manually if required. 

Bulk Deleting Domains

You can also bulk-delete domains by:

1. Checking the boxes for the domains you'd like to delete
2. Clicking Delete Selected Domains

Using Wildcard Domain Patterns

A wildcard pattern maps a whole group of subdomains to one brand in a single entry, so you don't have to add each one by hand. You add it on the Domain Management page exactly like a normal domain — the only difference is that the pattern contains one or more * characters.

For example, instead of adding [www.mydomain.com](https://www.mydomain.com), blog.mydomain.com, and shop.mydomain.com one at a time, add *.mydomain.com once, and every direct subdomain is served the same brand.

How to Add a Wildcard Domain

1. Navigate to Settings > Web and select the Domain Management tab. You'll see the table of domains already mapped to this brand.
2. Click "Add Domain". The Add new domain dialog opens.
3. Enter your wildcard pattern — for example, *.mydomain.com.
4. Click "Add Domain" to save. The dialog closes, and the new pattern appears in the domains table.

What the Asterisk Means

• A * stands for exactly one part of a domain — one "label", the piece between two dots. It matches one or more characters, but it never crosses a dot.
• You control the depth with dots. *.mydomain.com is one subdomain deep; *.*.mydomain.com is two deep.
• You can put * at the start of a label, inside a label, or as the final part — and you can use more than one.

What Wildcards Can't Do

These rules are enforced when you save. If a pattern breaks, you'll see an inline error in the dialog, and the pattern won't be saved.

1. A * only ever matches one label, and the depth must match exactly. *.mydomain.com covers [www.mydomain.com](https://www.mydomain.com) but not the bare mydomain.com, and not the deeper mail.support.mydomain.com. To cover two levels, use *.*.mydomain.com. There is no pattern that matches "any depth".
2. A pattern can't be only wildcards. * and *.* are rejected — "Wildcard pattern must contain at least one literal character". To catch every unmapped domain, use the Default Brand setting described below instead.
3. A wildcard can't match a whole top-level domain. *.com, *.uk, and play.*.com are rejected — "Wildcard cannot match an entire top-level domain". The part immediately before the final piece must contain real text.
4. Top-level-domain wildcards cover single-part endings only. mydomain.* matches mydomain.com and mydomain.io, but not mydomain.co.uk — multi-part endings like .co.uk need their own entry.
5. The normal domain rules still apply. No spaces, no http:// or https://, no paths, and the value must contain at least one dot.

How a Visitor's Domain Is Matched

When a visitor lands on one of your sites, Optimove picks the brand to serve in this order:

1. Exact match — a domain you added with no * always wins, even if a wildcard would also match it.
2. Most specific wildcard — if several wildcards match, the one with the fewest * characters (and the most literal text) wins.
3. Default Brand — if nothing matches and you've set one, the fallback brand is served.
4. Nothing — otherwise the visitor receives no Web configuration.

So you can safely keep *.mydomain.com mapped to Brand A alongside an exact shop.mydomain.com mapped to Brand B: shop.mydomain.com gets Brand B, and every other subdomain gets Brand A.

Removing or Changing a Pattern

• Remove one: click the Trash Can beside the pattern and confirm.
• Remove several: tick the checkboxes and click Delete Selected Domains.
• Change a pattern: delete the old one and add the corrected pattern — there is no in-place edit.

Deletions and changes are subject to the same 10-minute propagation window.

Setting a Default Brand

The Default Brand is a fallback: it's the brand Optimove serves when a visitor lands on a domain you haven't mapped to a specific brand.

• Without a Default Brand: visitors on unmapped domains receive no Web configuration at all — no push prompts, no inbox, nothing.
• With a Default Brand: visitors on unmapped domains receive the configuration of the brand you nominate as the fallback.

When to Use It

Set a Default Brand if you have one primary brand that should be served whenever a visitor arrives on a domain you haven't yet mapped — for example, a flagship site that should always be served, including on staging or preview URLs.

Leave it off if you'd rather an unmapped domain return nothing. This is the safer choice: it makes a missing mapping obvious rather than silently serving the fallback.

How to Set a Default Brand

1. Navigate to Settings > Web and select the Domain Management tab.
2. Turn on "Set a default brand".
3. Choose a brand from the dropdown.
4. Click Save and confirm in the dialog.

To change the Default Brand, choose a different brand and save again. To remove it, turn the toggle off and confirm.

To check it's working: after the propagation window, open a page on an unmapped domain in a browser and confirm your Web features — such as push prompts or the inbox — appear.

Things to Watch

• A Default Brand can hide mistakes. If you forget to map a new site, the Default Brand is served there instead of an obvious "nothing happened," which is harder to spot.
• Always add explicit mappings for every domain you intend to serve. Treat the Default Brand as a safety net, not a shortcut.
• The fallback only applies to real browser traffic. Server-side scripts, scrapers, and other tools that don't send a normal browser origin won't pick up the default; they continue to receive nothing.

Getting Help

If a domain mapping or Default Brand change isn't behaving as expected after the 10-minute propagation window, contact Optimove Support with:

• The tenant and the brand you mapped the domain or pattern to
• The exact domain or pattern you entered — for example, *.mydomain.com
• The domain you were testing on
• The time you saved the change

For technical implementation details, see the Web SDK Integration guide in the Optimove Developer Hub.