{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/products/namirialnotify/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Forwarding domains","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"forwarding-domains","__idx":0},"children":["Forwarding domains"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide explains how site administrators review, add, and verify domains used for sending notifications and email-related communications."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The verification screen provides the exact DNS records required for the domain you entered. If your tenant shows values that differ from the legacy examples below, always use the values shown by the current product UI."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["you are signed in with site administrator permissions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["you can access the organization settings area"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["you can make or request the required DNS changes for the domain"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"open-domains","__idx":2},"children":["Open domains"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization"]}," from the settings icon in the top-right toolbar."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domains"]}," in the left sidebar."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domains"]}," section lists sending domains configured for the organization. The list view includes an add-domain action, row actions, pagination, and columns for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["status"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["domain"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["description"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["update"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/admin-site-settings-domains.1a37cb754bb3b3411cc9feab4bd3cc5f1fe10f3be5d4b5f79451ff85a6460f78.6fd6141d.png","alt":"Domains section showing configured domains with status, domain, description, and update columns"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-a-domain","__idx":3},"children":["Add a domain"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domains"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the add-domain action."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the required ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete the DNS configuration required to verify that the domain belongs to your organization."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The current UI reminds you that:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["you must have access to the domain or subdomain DNS settings"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the platform will verify domain ownership through DNS configuration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["using a subdomain is recommended so you can continue sending email from the root domain"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/admin-site-settings-add-domain.527a33c0f6b05d82967675bfa7b4f88c8c2605bd95d5e004b31bda563a6a7a5f.6fd6141d.png","alt":"Add your domain screen showing the Domain and Description fields with guidance about DNS verification and the recommendation to use a subdomain"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"verify-the-domain","__idx":4},"children":["Verify the domain"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the domain is created, Namirial Notify opens the verification step and shows the DNS values that must be published for that domain."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review the DNS records shown in the verification screen."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the required SPF and DKIM values."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Publish the records in your DNS provider."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait for DNS propagation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return to the verification screen."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verify domain"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm that the verification indicators are updated."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The current verification screen exposes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a help panel that explains the DNS-verification process"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a summary of the selected ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Domain"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a DNS table with columns such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Type"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Hostname"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Enter this value"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Verified"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add custom DKIM key"]}," action"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verify domain"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," actions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the current UI, the DNS table typically contains:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["one SPF record with type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TXT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["two DKIM records with type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CNAME"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The exact hostnames and values are environment-specific. Always copy the values shown by the current product UI for the domain you are configuring."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"spf-configuration","__idx":5},"children":["SPF configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SPF record must authorize the sending infrastructure used by the platform."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the SPF row shown in the verification table for the exact ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Hostname"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Enter this value"]}," pair required by your tenant."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Current environments typically expose one SPF row with:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TXT"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the selected sending domain or subdomain as the hostname"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include:"]}," value that points to the platform SPF configuration for that environment"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Legacy environments required an SPF record that included ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["_spf.evicertia.com"]},". A legacy example was:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"example.com TXT \"v=spf1 mx include:_spf.evicertia.com ~all\"\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your current tenant can show a different hostname or include value in the verification screen. Copy the exact value shown there when configuring DNS."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"dkim-configuration","__idx":6},"children":["DKIM configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The verification flow can expose one of two DKIM approaches:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"shared-selectors","__idx":7},"children":["Shared selectors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Current environments typically expose two DKIM CNAME records in the verification table. The selector names can differ by environment, so copy the exact values shown by the UI."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Legacy environments commonly used two shared selectors provided by the platform. In that model, the DNS provider had to publish CNAME records following this pattern:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Selector"},"children":["Selector"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Hostname pattern"},"children":["Hostname pattern"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Target pattern"},"children":["Target pattern"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["herma-a"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["herma-a._domainkey.<your-domain>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["herma-a._domainkey.evicertia.com"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["herma-b"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["herma-b._domainkey.<your-domain>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["herma-b._domainkey.evicertia.com"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"herma-a._domainkey.acmedomain.com CNAME herma-a._domainkey.evicertia.com.\nherma-b._domainkey.acmedomain.com CNAME herma-b._domainkey.evicertia.com.\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"custom-selector","__idx":8},"children":["Custom selector"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the UI exposes ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add custom key"]},", you can create your own DKIM selector and publish a TXT record with the generated public key."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The resulting record usually follows this pattern:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"<selector>._domainkey.<your-domain> TXT \"v=DKIM1; k=rsa; p=<generated-public-key>\"\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the exact selector name and public key generated by the verification flow."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"relationship-with-profile-email-addresses","__idx":9},"children":["Relationship with profile email addresses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To register an email address for your existing user account, open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Profile > Emails"]}," and follow the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/admin/user-profile-settings#email-addresses"},"children":["Email addresses"]}," instructions. You do not need to create a new user account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An email address is active for sending notifications only if the site administrator has configured the corresponding domain and the required DNS changes have been completed."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-to-check","__idx":10},"children":["What to check"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before adding or changing a domain, confirm:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["you have permission to configure DNS for the domain or subdomain"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the domain belongs to the organization"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["using a subdomain is acceptable for the sending use case"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["registered user email addresses depend on the domain being configured and verified"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["DNS changes have propagated before treating the domain as ready"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["if you are using a custom DKIM selector, the published public key exactly matches the one generated by the platform"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["after successful verification, you still save the domain configuration from the verification screen"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"expected-result","__idx":11},"children":["Expected result"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The organization domain is listed in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domains"]},", the verification indicators show success for the required SPF and DKIM records, and user email addresses under that domain can become active."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":12},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/admin"},"children":["Admin overview"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/admin/site-settings"},"children":["Site settings"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialnotify/admin/user-profile-settings"},"children":["User profile settings"]}]}]}]},"headings":[{"value":"Forwarding domains","id":"forwarding-domains","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Open domains","id":"open-domains","depth":2},{"value":"Add a domain","id":"add-a-domain","depth":2},{"value":"Verify the domain","id":"verify-the-domain","depth":2},{"value":"SPF configuration","id":"spf-configuration","depth":2},{"value":"DKIM configuration","id":"dkim-configuration","depth":2},{"value":"Shared selectors","id":"shared-selectors","depth":3},{"value":"Custom selector","id":"custom-selector","depth":3},{"value":"Relationship with profile email addresses","id":"relationship-with-profile-email-addresses","depth":2},{"value":"What to check","id":"what-to-check","depth":2},{"value":"Expected result","id":"expected-result","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"Forwarding domains","description":"How to register and verify sending domains in Namirial Notify.","layout":"doc","outline":"deep","keywords":["forwarding domains","domains","DNS verification","email domain","namirial notify admin"],"seo":{"title":"Forwarding domains"}},"lastModified":"2026-10-15T10:56:05.000Z","isTranslationFallback":true,"pagePropGetterError":{"message":"","name":""}},"slug":"/it/products/namirialnotify/admin/forwarding-domains","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}