diff --git a/docs/docs/basic-features/managing-features.md b/docs/docs/basic-features/managing-features.md
index 052f9be469b6..e8e3f7de012f 100644
--- a/docs/docs/basic-features/managing-features.md
+++ b/docs/docs/basic-features/managing-features.md
@@ -96,3 +96,12 @@ other Environments within the Project.
 ### Multi-Variate Flag Use Cases
 
 The primary use case for using Multi-Variate flags is to drive [A/B tests](/advanced-use/ab-testing.md).
+
+### Use Metadata
+
+When creating or updating a feature, you can enhance its information by adding previously created and enabled metadata fields.
+To create and enable this you can do it in the metadata tab on the project settings page.
+
+Then, add it using the "Add Metadata" button within the feature.
+
+![Image](/img/metadata/metadata-feature-1.png)
diff --git a/docs/docs/basic-features/managing-segments.md b/docs/docs/basic-features/managing-segments.md
index b55f038d02e9..167d8b0bf6fb 100644
--- a/docs/docs/basic-features/managing-segments.md
+++ b/docs/docs/basic-features/managing-segments.md
@@ -241,3 +241,12 @@ More simply, the order of precedence is:
 1. Identity
 2. Segment
 3. Flag
+
+## Use Metadata
+
+When creating or updating a segment, you can enhance its information by adding previously created and enabled metadata fields.
+To create and enable this you can do it in the metadata tab on the project settings page.
+
+Then, add it using the "Add Metadata" button within the segment.
+
+![Image](/img/metadata/metadata-segment-1.png)
diff --git a/docs/docs/system-administration/environment-settings.md b/docs/docs/system-administration/environment-settings.md
index fd7b6a9cef70..5a3e870a5ddf 100644
--- a/docs/docs/system-administration/environment-settings.md
+++ b/docs/docs/system-administration/environment-settings.md
@@ -16,3 +16,12 @@ This will result in identities receiving different variations and being evaluate
 split operator) when evaluated against the remote API. Evaluations in local evaluation mode will not be affected.
 
 :::
+
+## Use Metadata
+
+When creating or updating a segment, you can enhance its information by adding previously created and enabled metadata fields.
+To create and enable this you can do it in the metadata tab on the project settings page.
+
+Then, add it using the "Add Metadata" button in the metadata tab inside environemt settings.
+
+![Image](/img/metadata/metadata-environment.png)