diff --git a/src/content/docs/markets/collection-imports.mdx b/src/content/docs/markets/collection-imports.mdx
index f6d74cb..931538c 100644
--- a/src/content/docs/markets/collection-imports.mdx
+++ b/src/content/docs/markets/collection-imports.mdx
@@ -49,6 +49,21 @@ publish.
 Gallery imports read the parent inscription's children and are published as
 **Unverified**.
 
+## Where traits come from
+
+| Source | What it adds |
+| --- | --- |
+| Pinned open registry | Names and item traits, read from a fixed, reviewable revision |
+| Marketplace sources | Item traits and collection details where the registry has none |
+| Universe indexers | Native facts: supply, decimals, deployment, block and name records |
+
+When two sources disagree, the registry wins and the other answer is kept as a
+recorded conflict. A source that fails never wipes traits that are already
+known, and an item with no traits is shown as having none, not as missing.
+
+Tokens such as BRC-20, Runes or CAT-20 show their real deployment properties.
+They never get invented artwork traits.
+
 ## What an import controls, and what it does not
 
 An import proposes collection **metadata and membership**. It does not control:
diff --git a/src/content/docs/markets/collection-markets.mdx b/src/content/docs/markets/collection-markets.mdx
index c9db8a3..d48906e 100644
--- a/src/content/docs/markets/collection-markets.mdx
+++ b/src/content/docs/markets/collection-markets.mdx
@@ -40,6 +40,23 @@ enrichment provider is offline.
 
 Listings overlay inventory and never create membership.
 
+## Traits on every item
+
+Open any item to see its traits as cards: the trait, the value, and how rare it
+is. Rarity is the share of the collection's known members carrying that value.
+When the full membership is not known yet, the card shows the count only.
+
+Token markets show **Properties** instead: the deployment facts of the token,
+such as supply and decimals, read from Universe indexers.
+
+| State | What you see |
+| --- | --- |
+| Ready | Traits and properties with counts |
+| Partial | What is known so far, marked as partial |
+| None | The item has no traits |
+| Updating | The last good values, with the time of the last update |
+| Unavailable | A short notice and a retry button |
+
 ## Finding an item
 
 Search, price, listing status, sorting, and traits work together. Trait choices
diff --git a/src/content/docs/markets/collection-media.mdx b/src/content/docs/markets/collection-media.mdx
index 9bc67cd..fee7a74 100644
--- a/src/content/docs/markets/collection-media.mdx
+++ b/src/content/docs/markets/collection-media.mdx
@@ -22,6 +22,18 @@ Core mirrors supported artwork, metadata, thumbnails, renders, audio, and video
 into one shared media system, covering Ordinals, DMT, UNAT, Doginals,
 Atomicals, Bitcoin Stamps, and other supported families.
 
+## Traits and properties are stored too
+
+Collection details, item traits and token properties live in the same private
+store as artwork, in their own space. Each refresh is saved as a complete,
+sealed snapshot: the raw source answers, the cleaned collection and items, the
+trait counts, and a manifest that lists every piece by its exact fingerprint.
+
+The pages you browse read that snapshot back and check every fingerprint before
+showing a value. A snapshot replaces the previous one only after it is complete
+and checked, so you never see half of an update. If a source goes quiet, the
+last good snapshot stays on screen.
+
 ## Originals and derivatives are different things
 
 The exact bytes discovered from a chain or an authoritative Universe index are