Analytics Catalog

The Analytics Catalog provides a single place to browse and manage the semantic objects in a workspace, such as dashboards, visualizations, metrics, attributes, facts, and date datasets. It helps workspace managers to keep analytics assets organized and easier to understand as the workspace grows. The Analytics Catalog enables direct editing of object properties, or it provides a link to a specific application where you can do more complex updates.

You can open the Analytics Catalog from the Home page. It is available to users with the following permissions: Organization.MANAGE, Workspace.MANAGE, and Workspace.ANALYZE. Permissions also control which objects you can edit in the catalog.

Key Capabilities

Search and Filter

Use the search field to find objects by title and description. You can further refine results with filters, for example:

• object type
• creator
• tags
• relationships (parent and child)

You can apply multiple filters at the same time. Filters are combined using logical AND, allowing you to refine results with precision. The catalog uses lazy loading, so more results load as you scroll.

Object Details

Select an object to open its detailed metadata view. The details view includes:

• name and description
• object type and ID
• tags
• created by and created date
• last modified by and last modified date
• dataset information for attributes and facts

In the details view, you can edit some information or open the object in the relevant editor, provided you have sufficient permissions in the workspace. Changes are saved immediately.

You can also copy the URL of the details view and share it with a colleague for review.

Tags

Tags help group and filter objects in large workspaces. For example, you can tag a metric with products so it appears grouped in the Analytical Designer.

• Tags are shown in the Tags column.
• You can filter the catalog by using the filter and selecting tags as filter values, or alternatively, click a tag value directly in the table.

Hide Objects from AI Results

The Analytics Catalog can show and edit whether an object is hidden from AI. Hidden objects remain available in the catalog, but they are not used or suggested by AI features.

In the catalog list, hidden objects are marked with an icon. You can use filters to show:

• all objects
• only objects hidden from AI
• only objects visible to AI

Embeddability

The Analytics Catalog can be embedded into custom applications using the GoodData.UI SDK. This allows you to integrate catalog browsing and object management directly into your own user interfaces while keeping the same behavior and permissions as in the GoodData UI.

The SDK provides ready-to-use React components for browsing catalog items and displaying object details. For more information about the SDK, see the GoodData.UI documentation.

AnalyticsCatalog Component

The AnalyticsCatalog component renders a full interactive catalog view. It lists dashboards, visualizations, metrics, attributes, and facts, and includes built-in search, filtering, and object detail access.

The component uses the backend and workspace from context, or you can pass them directly as props.

Example:

import { AnalyticsCatalog } from "@gooddata/sdk-ui-catalog";
import { BackendProvider, WorkspaceProvider } from "@gooddata/sdk-ui";

// Import styles once in your application
import "@gooddata/sdk-ui-catalog/styles/css/main.css";

export function App() {
    return (
        <BackendProvider backend={backend}>
            <WorkspaceProvider workspace="workspace_id">
                <AnalyticsCatalog />
            </WorkspaceProvider>
        </BackendProvider>
    );
}

You can also provide the backend and workspace explicitly:

<AnalyticsCatalog backend={backend} workspace="workspace_id" />

AnalyticsCatalogDetailContent Component

If you want to embed only the object detail view into your own layout, you can use the AnalyticsCatalogDetailContent component. This is useful when you want full control over layout and navigation, but still reuse the catalog detail UI.

Example:

import { AnalyticsCatalogDetailContent } from "@gooddata/sdk-ui-catalog";
import "@gooddata/sdk-ui-catalog/styles/css/detail.css";

export function App() {
    return (
        <AnalyticsCatalogDetailContent
            objectId="object_id"
            objectType="insight"
        />
    );
}

AnalyticsCatalogDetail Component

The AnalyticsCatalogDetail component provides a ready-to-use overlay with object details and actions. It is suitable when you want a modal-style experience similar to the native Analytics Catalog.

Example:

import { useState } from "react";
import { AnalyticsCatalogDetail } from "@gooddata/sdk-ui-catalog";
import "@gooddata/sdk-ui-catalog/styles/css/detail.css";

export function App() {
    const [open, setOpen] = useState(true);

    return (
        <AnalyticsCatalogDetail
            open={open}
            onClose={() => setOpen(false)}
            objectId="object_id"
            objectType="insight"
        />
    );
}

Permissions and Behavior

Embedded catalog components respect the same permissions as the Analytics Catalog in the GoodData UI. Users only see and can edit objects they have access to in the workspace.

Search, filtering, object visibility, and AI-related settings behave consistently across embedded and native experiences.