diff --git a/docs/canvas-pilot/changelog.md b/docs/canvas-pilot/changelog.md
index 72da857..0a9c9a1 100644
--- a/docs/canvas-pilot/changelog.md
+++ b/docs/canvas-pilot/changelog.md
@@ -4,6 +4,9 @@
## Unreleased
+- Clarified that Gold ranks preservation within Canvas Pilot: `.pilot.json` is
+ application-specific, not an industry-standard format for other editors.
+
- Moved format tiers and pills above the feature matrix, restoring plain format
names in the comparison table.
diff --git a/docs/canvas-pilot/guide/advanced-exchange.md b/docs/canvas-pilot/guide/advanced-exchange.md
index 7b7c335..2b2bdf4 100644
--- a/docs/canvas-pilot/guide/advanced-exchange.md
+++ b/docs/canvas-pilot/guide/advanced-exchange.md
@@ -5,6 +5,9 @@
Gold saves the full project. Silver restores an optional embedded snapshot. Bronze
imports geometry only. These tiers describe Canvas Pilot state preservation, not
application quality or a guarantee that third-party editors retain metadata.
+Gold uses Canvas Pilot’s application-specific `.pilot.json` format, intended only
+for Canvas Pilot. It is not an industry standard or a measure of compatibility
+with other editors; use an exchange format for those workflows.
## Which editing features survive?
diff --git a/docs/canvas-pilot/guide/format-matrix.md b/docs/canvas-pilot/guide/format-matrix.md
index e288ed7..a65e5f8 100644
--- a/docs/canvas-pilot/guide/format-matrix.md
+++ b/docs/canvas-pilot/guide/format-matrix.md
@@ -19,7 +19,10 @@ Tiers describe preservation of Canvas Pilot settings. Formats within a tier are
tied; choose the one your editor supports.
- **🥇 Gold — complete project:** 
- `.pilot.json` retains editable state and images.
+ `.pilot.json` retains editable state and images. **It is Canvas Pilot’s own
+ project format, intended to be opened only in Canvas Pilot—not an industry
+ standard or a file for other editors.** For sharing with another application,
+ choose one of the exchange formats below.
- **🥈 Silver — optional snapshot:**        
These formats preserve advanced settings when extra parameters are enabled.
- **🥉 Bronze — geometry/artwork:**   
diff --git a/docs/templates/canvas-pilot/catalog.md b/docs/templates/canvas-pilot/catalog.md
index 948af65..fb1622d 100644
--- a/docs/templates/canvas-pilot/catalog.md
+++ b/docs/templates/canvas-pilot/catalog.md
@@ -28,7 +28,8 @@ application or import it through **Import → Geometry file…** in Canvas Pilot
Review the detected rectangles and their destination layers before applying.
Tiers follow the [format matrix](../../canvas-pilot/guide/format-matrix.md):
-**Gold** is a complete `.pilot.json` project saved in Canvas Pilot; **Silver** formats
+**Gold** is a complete `.pilot.json` project for Canvas Pilot only, not an industry
+exchange standard; **Silver** formats
can carry optional advanced-settings snapshots; **Bronze** exchanges geometry/artwork.
These starter downloads are plain geometry templates, without embedded snapshots.