Your GoodData Domain

Within the GoodData platform, a domain is a data entity that stores all your users and workspaces. At the technical level, a domain corresponds to a partition in the database.

You can have multiple domains in the GoodData platform. White-labeled workspaces must be stored in separate domains.

Create a New Domain

You can have multiple domains when your company manages multiple products or when you require a separate domain for a testing environment.

A new domain can only be created by GoodData Support following your request.


  1. Prepare a domain name. It must be lower-case and without spaces, for example, mycompany.
  2. Prepare a domain administrator account. A domain administrator account is a GoodData platform account with an email address and a user name (in the form of an email address).  Recommendations: 
    • A domain administrator acccount is not tied to an individual.
    • A domain administrator acccount is unique within your company and tied to the name of the domain, for example,
  3. Create a GoodData support ticket with “Create Domain for My Company” as the subject.

Domain Administrator Role

Domain administrators can add, edit, and delete users in a domain.

The following chart illustrates the relationship between domains, workspaces, and their administrators. 

The domain administrator and the workspace administrator are two distinct roles with separate responsibilities. You can decide to what extent you want to combine the two roles.

You can manage domain admins in your domain via the API.

Domain Hierarchy

The GoodData platform is organized in the following hierarchy:

Users can be assigned to any number of workspaces in the domain. For example, in the image above User 1 is assigned to Workspace 1 only, User 2 is assigned to Workspace 1 and Workspace 2, and User 3 is assigned to zero workspaces.

At a technical level, the workspace object contains additional information.

For more information on these terms, see GoodData Glossary.