White-Label an Existing Domain

To white-label an existing domain, follow these steps:

  1. Select a URL for the white-labeled domain. For example:

    https://analytics.yourcompany.com

    Having a domain hosted on a subdomain of another GoodData domain is not supported.

    For example, if your white-labeled domain is https://analytics.yourcompany.com , you cannot have another domain at https://dev.analytics.yourcompany.com.

  2. Select an administrator for the new domain.
    For more information, see Choose a Domain Administrator.
  3. Gather project IDs of the projects to migrate or the customer token for your current domain.
  4. Ask your domain administrator to set up a CNAME.
    For more information, see Set up a CNAME and Acquire a TLS Certificate.
  5. If you decided to manage TLS certificates yourself (see Set up a CNAME and Acquire a TLS Certificate), ask a technical administrator at your company to generate a TLS certificate.

    The other option of managing TLS certificates is to let GoodData do it for you using Let's Encrypt. If you use this option, you do not have to generate a TLS certificate. For more information, see Set up a CNAME and Acquire a TLS Certificate.


After you acquire the necessary information, follow these steps:

  1. Open a request to create the white-labeled domain with GoodData Support.
    Include the following assets, which you gathered in the previous procedure, in this request:
    • URL for the white-labeled domain
    • Project IDs or customer token
    • Confirmation of CNAME creation
    • GoodData domain where you want to apply white labeling
    • (If you decided to manage TLS certificates yourself) Public and private components of the TLS certificate
    GoodData coordinates the rollout schedule with you and creates the white-labeled domain. This process typically takes two weeks.
  2. Coordinate rollout of the white-labeled domain.
    For more information, see Coordinate Rollout.
  3. Customize the domain using the GoodData APIs.
    For more information, see Customize the White-Labeled Domain.
  4. (Optional) Configure the DomainKeys Identified Mail (DKIM) email authentication method for outgoing emails.
    For more information, see Configure DKIM for Outgoing Email.
Powered by Atlassian Confluence and Scroll Viewport.