> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-metadata.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Learning Resources

> Add, organize, and manage in-product learning content (videos, Storylane tours, links, and PDFs) that surface contextually across OpenMetadata.

# Learning Resources

Learning Resources are short videos, Storylane walkthroughs, links, and PDFs that teach users how to use a specific feature. Each resource is tagged with one or more **Contexts** (the product pages it's relevant to), so it can surface as contextual, in-product help wherever a user might need it, in addition to being browsable from a central admin list.

## How to Access

To view and manage Learning Resources, navigate to **Settings** > **Preferences** > **Learning Resources**.

![Navigate to Learning Resources](https://mintcdn.com/openmetadata/ySHgZaFEeetr-rkP/public/images/how-to-guides/admin-guide/learning-resource/navigate-learning-resources.png?fit=max\&auto=format\&n=ySHgZaFEeetr-rkP\&q=85\&s=c881589a4fedbd3dcde52a91c046bf59)

## Overview

The Learning Resources page lists every resource that's been added to the platform, along with its categories, contexts, and last-updated date. From here:

* Search and filter the existing library.
* Switch between a table view and a card view.
* Add a new resource.
* Edit or delete an existing resource.

![Learning Resources page](https://mintcdn.com/openmetadata/O2KnVcpK1TH39_0Y/public/images/how-to-guides/admin-guide/learning-resource/learning-resource-page.png?fit=max\&auto=format\&n=O2KnVcpK1TH39_0Y\&q=85\&s=5bccfc16a2f7ae3312a6e8912c6110ac)

## Add a Resource

To add a resource, follow these steps:

1. Navigate to **Settings** > **Preferences** > **Learning Resources**.

2. Click **Add Resource**.

   ![Add Resource button](https://mintcdn.com/openmetadata/O2KnVcpK1TH39_0Y/public/images/how-to-guides/admin-guide/learning-resource/add-resource.png?fit=max\&auto=format\&n=O2KnVcpK1TH39_0Y\&q=85\&s=cd009f23312ae9098a60d076f2dd355d)

3. Fill in the following fields:

   * **Name** (required): The internal name for the resource. This cannot be changed after the resource is created.
   * **Description** (required): A short summary of what the resource teaches, shown to users before they open it.
   * **Type** (required): The kind of content this is.
     * **Video**: An embedded video (for example, hosted on YouTube or Vimeo).
     * **Storylane**: An interactive Storylane product tour.
     * **Link**: A link to a web page, such as a documentation article. It opens in a new browser tab.
     * **PDF**: A PDF document, shown in the resource viewer.
   * **Categories** (required): One or more topic groupings used for browsing and filtering. Available categories: **Discovery**, **Governance**, **Data Quality**, **Observability**, **Admin**, **AI**.
   * **Context** (required): One or more product pages where this resource should surface — for example, **Glossary**, **Domain**, **Data Quality**, **Explore**, **Automations**, or **Home Page**. See [Where Learning Resources Appear](#where-learning-resources-appear) for how this drives visibility elsewhere in the product.
   * **Source URL** (required): The link to the video, Storylane tour, web page, or PDF, for example `https://www.youtube.com/watch?v=...`. Must be a valid URL. A **Link** or **PDF** resource requires an `http` or `https` URL.
   * **Source Provider** (optional): A free-text label for the hosting platform, for example `YouTube` or `Storylane`.
   * **Duration** (optional): The approximate length of the resource, selected from a preset list (1–30 minutes).
   * **Status** (optional): The resource's publishing state. Defaults to **Active**.
     * **Active**: Visible to users, both in the admin list and in contextual drawers.
     * **Draft**: Not shown to end users — use this while the resource is still being prepared.
     * **Deprecated**: Retired content, kept for reference but hidden from users.

   ![Add Resource form](https://mintcdn.com/openmetadata/ySHgZaFEeetr-rkP/public/images/how-to-guides/admin-guide/learning-resource/resource-details.png?fit=max\&auto=format\&n=ySHgZaFEeetr-rkP\&q=85\&s=cf890d5606907ba39e57f9ebebf85aed)

4. Click **Save** to create the resource.

## View and Manage Resources

Use the search box, filters, and view toggle to work through the resource library, or edit and delete existing entries.

### Search

Use the **Search Resource** box to filter the list by name as you type.

![Search resources](https://mintcdn.com/openmetadata/ySHgZaFEeetr-rkP/public/images/how-to-guides/admin-guide/learning-resource/search-resources.png?fit=max\&auto=format\&n=ySHgZaFEeetr-rkP\&q=85\&s=6c0a4433ac08aa8b1daf4068666deb9a)

### Filters

Use the filter dropdowns to narrow the list by:

* **Type**: Video, Storylane, Link, or PDF.
* **Categories**: One or more topic categories.
* **Context**: One or more product pages the resource is tagged for.
* **Status**: Active, Draft, or Deprecated.

Active filters appear as removable chips above the list. Click **Clear all** to reset every filter at once.

![Filter resources](https://mintcdn.com/openmetadata/O2KnVcpK1TH39_0Y/public/images/how-to-guides/admin-guide/learning-resource/filter-resources.png?fit=max\&auto=format\&n=O2KnVcpK1TH39_0Y\&q=85\&s=aa532547c9b3be75c3c04c2ce838f5e3)

### View Mode

Use the view toggle in the top-right corner of the list to switch between:

* **Table view**: A compact list showing Content Name, Categories, Context, and when the resource was last updated.
* **Card view**: A grid of resource cards, useful for browsing visually.

Clicking a resource, in either view, opens a preview modal for its content, with a fullscreen option. A **Link** resource opens in a new browser tab instead.

![Table and card view toggle](https://mintcdn.com/openmetadata/ySHgZaFEeetr-rkP/public/images/how-to-guides/admin-guide/learning-resource/view-mode.png?fit=max\&auto=format\&n=ySHgZaFEeetr-rkP\&q=85\&s=16b245de622f4b06efd0331af379b551)

### Edit and Delete

Use the icons in the **Action** column to edit or delete a resource:

* To edit a resource:
  1. In the **Action** column, click the edit icon.
  2. Modify the details. All fields are editable except **Name**.
* To delete a resource:
  1. In the **Action** column, click the delete icon.
  2. In the pop-up, click **Delete** to permanently remove the resource.

![Edit and delete a resource](https://mintcdn.com/openmetadata/O2KnVcpK1TH39_0Y/public/images/how-to-guides/admin-guide/learning-resource/edit-delete-resource.png?fit=max\&auto=format\&n=O2KnVcpK1TH39_0Y\&q=85\&s=0260f1808829234377c7cc493d23a2d4)

## Where Learning Resources Appear

Beyond the admin list under **Settings** > **Preferences** > **Learning Resources**, **Active** resources also surface directly inside the product as contextual help. Pages that support this show a small learning icon in their header — for example, on the Glossary, Domains, Data Products, Explore, Tags, Metrics, Test Suites, Governance Workflows, Automations, and Data Insights pages, among others.

![Resource icon](https://mintcdn.com/openmetadata/ySHgZaFEeetr-rkP/public/images/how-to-guides/admin-guide/learning-resource/resource-icon.png?fit=max\&auto=format\&n=ySHgZaFEeetr-rkP\&q=85\&s=33ffd960f8675b573fd434a8348cd842)

1. Hover over the icon to see how many resources are available for that page.

   ![Hover over the resource icon](https://mintcdn.com/openmetadata/O2KnVcpK1TH39_0Y/public/images/how-to-guides/admin-guide/learning-resource/hover-resource-icon.png?fit=max\&auto=format\&n=O2KnVcpK1TH39_0Y\&q=85\&s=32349f187da06765c0b8f7b3275e8704)
2. Click the icon to open a drawer listing every **Active** resource whose **Context** includes that page.

   ![Active resource listing](https://mintcdn.com/openmetadata/O2KnVcpK1TH39_0Y/public/images/how-to-guides/admin-guide/learning-resource/active-resource-listing.png?fit=max\&auto=format\&n=O2KnVcpK1TH39_0Y\&q=85\&s=0399150e97f71bdf9a10c7e44ac70c26)
3. Click a resource in the drawer to view its content.

This is why **Context** is a required field when adding a resource: it determines which page(s) will show the resource in this contextual drawer, independent of where it appears in the admin list.

## Best Practices

* Keep resources scoped to the **Context** where they're actually useful — over-tagging a resource with unrelated contexts adds noise to those pages' help drawers.
* Use **Draft** status while preparing a resource so it doesn't appear to end users until it's ready, then switch it to **Active** to publish it.
* Prefer short, focused videos or Storylane tours over long ones — the contextual drawer is meant for quick, in-the-moment help.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.