Essential Terms and Concepts

Review the information in this article to get the most out of the GoodData platform. Knowledge of the following terms and concepts is essential to use GoodData effectively.



A workspace is an analytical environment of the GoodData platform. Workspaces are where you load your data and arrange it into a logical data model.

You can create multiple workspaces addressing either different analytical use cases, or the same use case for different groups of your clients. For example, if you have four sets of data from four different customers that need analytics, you should create a workspace that corresponds to each customer.

Access to workspaces is granted to users and depending on their role, they can use, create or modify the objects.

For your first workspace, we recommend that you use the Demo workspace to familiarize yourself with the capabilities of the GoodData platform.

KPI Dashboard

The KPI Dashboard presents the insights you create in the Analytic Designer to end users. KPI Dashboards can also contain descriptions and additional filters. You can view the KPI Dashboards from within the GoodData Portal or from another application that the KPI Dashboard is embedded into. You will find KPI Dashboards under the KPIs tab in the GoodData toolbar.

Analytical Designer

Analytical Designer is a GoodData component used for building insights. You or your clients can build insights from measures and other logical data model elments in an intuitive drag and drop user interface. You can also embed Analytical Designer into another application. You will find the Analytical Designer under the Analyze tab in the GoodData toolbar.


Insights are visualizations (tables or charts of various types) which display the values of measures calculated in the context of selected attributes. Insights are local to individual workspaces. They can be placed onto KPI Dashboards to be presented to the end users. You build insights in the Analytical Designer from the Analyze tab in the GoodData toolbar.


Measures are a numerical piece of data that mathematical functions work on, for example, the price of an item or the quantity of items. This data can be used to measure a business process when creating an insight. Facts from the logical data model (LDM) are available as measures.


Facts are one of the objects in the Logical Data Model (LDM). If you think of a dataset as a table, a fact is a column with a numerical value in it (measurements, amounts, sizes etc.)

When creating an insight, facts from the LDM are available as measures.


Attributes are one of the objects in the Logical Data Model (LDM). If you think of a dataset as a table, an attribute is a column with a string value in it. It typically is a text value that gives context to the facts, but an attribute can also be a numerical value. 

Attribute values are used for slicing and filtering.

Calculated Measure

Calculated Measures (also known as metrics) define how to calculate (slice) your data. Calculated Measures are specific to a workspace and are written in a GoodData-specific language called MAQL. Calculated Measures can be the simple aggregation of facts (SUM(revenue)), the count of distinct values for attributes (COUNT(product)), or more complex expressions that include filtering or other business logic.

Calculated Measures can be reused to calculate different contexts for your data. For example, a calculated measure for revenue can be viewed (sliced) by region or by month. You can also nest calculated measures and define one calculated measure using another calculated measure.


Aggregation is the process of grouping the values of multiple instances of a particular numerical fact into a single value by using aggregation functions such as sum, average, minimum, maximum, and count. For example, the price of order #1 and the price of order #2 can be aggregated into a single value that reflects the sum for orders. This summary value can then be reported or further manipulated for analytics.


MAQL stands for Multi-Dimension Analytical Query Language and it is an analytical language developed by GoodData. It works with the dimensional Logical Data Model and allows you to define various operations from simple aggregations of facts to advanced things like locking calculated measures by various attributes, selective filtering or filter exclusions, or comparing data points with previous time periods.


Slicing is when you calculate a measure by a particular attribute or a set of attributes. If you are looking at a revenue measure grouped by region, you can say the revenue is sliced by region. By their very nature, calculated measures are slices of the facts used to create them. These calculated measures can then be further sliced with additional attributes.


Filtering typically means limiting the set of data that is going to be analyzed or visualized.

In GoodData you can apply filters in several places, and the filters can be combined. For example a calculated measure can have a filter as a part of its MAQL definition and an insight can be filtered by an attribute or a measure. KPI dashboards can also contain filters by which end users can further narrow the analysis.

Logical Data Model (LDM)

Each workspace has a logical data model (LDM) which defines what data is available for analysis and what the relationship is between different data entities (datasets). In GoodData, the LDM is often represented by a diagram with arrows connecting datasets in hierarchies. This diagram can be referred to when building calculated measures and insights.

The LDM defines what calculated measures you can create using MAQL, as well as how you can slice and filter your data. Because the insights that are available to you are based on the LDM you create, the LDM should be created with your reporting requirements taken into consideration.

Whether you load your data to a GoodData workspace from a data warehouse or from a CSV file, you will always create a logical data model.


Datasets are the basic organizational unit of the Logical Data Model. They are a collection of related facts, attributes, and references. You can imagine a dataset as a table or a collection of tables.

Datasets hold the data loaded into them as records. Each dataset should have a defined granularity.


Granularity is a term that refers to the level of detail (also known as grain) stored in a table. For example, if you have a table that contains the attributes Date, Store, and Product, the level of detail is products sold in store by day. Within a dataset, granularity refers to what each particular record in the dataset represents. This is often determined by the primary key. All records in a dataset should have the same granularity. Ideally, the level of detail should be at the lowest level.

Primary Key

The primary key is a value that uniquely identifies every single record in a table/dataset. In the case of the GoodData Logical Data Model, the primary key can either be an attribute or a set of attributes.


A multi-tenant setup as it applies to GoodData means you can build an analytical application and then scale it to hundreds or thousands of your customers (tenants). You can provide each customer their own workspace with a Logical Data Model and predefined common KPI Dashboards and calculated measures, and they can customize their workspace with custom insights or calculated measures. You can use the Life Cycle Management to create and maintain the workspaces and release new versions of your dashboards while retaining the modifications.


Embedding as it applies GoodData means putting a piece of the GoodData application into another application. Examples of components which can be embedded into iframes are KPI Dashboards and Analytical Designer. Insights can also be embedded on the front-end source code level using GoodData.UI React components. Embedding is often used while building multi-tenant analytical applications.

Powered by Atlassian Confluence and Scroll Viewport.