diff --git a/.chloggen/decouple_shared_memory_metric.yaml b/.chloggen/decouple_shared_memory_metric.yaml
index 99f1e15a55..5f5fb7be4e 100755
--- a/.chloggen/decouple_shared_memory_metric.yaml
+++ b/.chloggen/decouple_shared_memory_metric.yaml
@@ -10,7 +10,7 @@ change_type: 'breaking'
component: system
# A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`).
-note: Remove `shared` from `system.memory.state` values and make it a standalone metric
+note: Deprecate `shared` from `system.memory.state` values and make it a standalone metric
# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
# The values here must be integers.
diff --git a/docs/attributes-registry/system.md b/docs/attributes-registry/system.md
index a7db5e3fb9..a836fce9a9 100644
--- a/docs/attributes-registry/system.md
+++ b/docs/attributes-registry/system.md
@@ -52,9 +52,9 @@
|---|---|---|
| `used` | used |  |
| `free` | free |  |
+| `shared` | shared | 
Removed, report shared memory usage with `metric.system.memory.shared` metric |
| `buffers` | buffers |  |
| `cached` | cached |  |
-| `shared` | shared | 
Removed, report shared memory usage with `metric.system.memory.shared` metric |
## Paging attributes
diff --git a/docs/system/system-metrics.md b/docs/system/system-metrics.md
index 0938fbbe08..2c604cefc9 100644
--- a/docs/system/system-metrics.md
+++ b/docs/system/system-metrics.md
@@ -203,9 +203,9 @@ available on the system, that is `system.memory.limit`.
|---|---|---|
| `used` | used |  |
| `free` | free |  |
+| `shared` | shared | 
Removed, report shared memory usage with `metric.system.memory.shared` metric |
| `buffers` | buffers |  |
| `cached` | cached |  |
-| `shared` | shared | 
Removed, report shared memory usage with `metric.system.memory.shared` metric |
### Metric: `system.memory.limit`
@@ -257,9 +257,9 @@ This metric is [recommended][MetricRecommended].
|---|---|---|
| `used` | used |  |
| `free` | free |  |
+| `shared` | shared | 
Removed, report shared memory usage with `metric.system.memory.shared` metric |
| `buffers` | buffers |  |
| `cached` | cached |  |
-| `shared` | shared | 
Removed, report shared memory usage with `metric.system.memory.shared` metric |
## Paging/Swap Metrics
diff --git a/model/registry/system.yaml b/model/registry/system.yaml
index 9f64cc4519..0766d4c8b2 100644
--- a/model/registry/system.yaml
+++ b/model/registry/system.yaml
@@ -65,16 +65,16 @@ groups:
- id: free
value: 'free'
stability: experimental
+ - id: shared
+ value: 'shared'
+ stability: experimental
+ deprecated: 'Removed, report shared memory usage with `metric.system.memory.shared` metric'
- id: buffers
value: 'buffers'
stability: experimental
- id: cached
value: 'cached'
stability: experimental
- - id: shared
- value: 'shared'
- stability: experimental
- deprecated: 'Removed, report shared memory usage with `metric.system.memory.shared` metric'
stability: experimental
brief: "The memory state"
examples: ["free", "cached"]