Skip to main content
Community Hub

Understand how descriptions are stored

TL;DR

Learn where Atlan stores the three kinds of asset description, which one appears in the UI, and what happens when you accept or edit an AI-generated description.

Your AI can read this via Docs MCPcurl -fsSL "https://docs.atlan.com/install-docs-mcp" | bashConnect

An asset in Atlan can hold three descriptions at once, written by three different sources. Knowing which is which explains most questions about enrichment—why an agent skipped an asset, which description appears on the asset profile, and what changes when you accept an AI suggestion.

Three kinds of description​

DescriptionWritten byExample
Source descriptionYour source system, during a crawlA Snowflake COMMENT on a table
User descriptionA person in AtlanSomeone edits the description field on an asset
AI-generated descriptionA context agentThe Description agent enriches a collection

These are stored separately. Clearing one doesn't clear the others, and each is updated by its own process.

Which description appears​

When an asset has more than one, Atlan displays them in this order:

  1. User description
  2. AI-generated description
  3. Source description

The highest one present wins. An AI-generated description appears ahead of a description crawled from your source system, and both give way to one your team wrote.

AI-generated descriptions carry a sparkle icon so you can tell at a glance where the text came from.

Lineage views don't show descriptions

Asset cards in lineage don't display a description at all, regardless of which ones the asset holds.

What agents skip, and why​

A context agent enriches an asset only when all three descriptions are empty. If any one of them holds a value, the agent skips that asset and moves on.

This is why an asset with a source description is skipped even though nobody in Atlan has documented it. As far as the agent is concerned, a description already exists.

Two consequences worth planning around:

  • Crawlers re-apply source descriptions. If your source system holds a description and you clear it in Atlan, the next crawl writes it back—and the asset becomes ineligible for enrichment again. To enrich it, remove the description at the source or stop the crawler from overwriting it.
  • Blank-looking values count as blank. Empty text, spaces, and the literal word None are all treated as no description, so those assets stay eligible.

Agents write only to the AI-generated description. Your source and user descriptions are never overwritten.

Accepting or editing AI descriptions​

Accepting an AI-generated description behaves differently depending on whether you edit it first:

  • Accept it as written: the text stays an AI-generated description. It keeps its sparkle icon and still counts as AI-generated in search filters.
  • Edit it before saving: the text becomes a user description, and the AI-generated description is cleared. The asset no longer appears under AI-generated filters, because the content is now authored by your team.

The second behavior is deliberate—once you've edited the text, it's your team's wording rather than the agent's. It's also the route to take when you want a description to reach your source system, since only user descriptions are pushed back.