From bd63f371ecb0ffd3cbefd521dd507b2fd22f2fc3 Mon Sep 17 00:00:00 2001
From: Vladyslav Diachenko <82767850+vlad-diachenko@users.noreply.github.com>
Date: Mon, 25 Sep 2023 14:20:09 +0300
Subject: [PATCH] Update structured-metadata docs (#10698)

OSS users tried to use the structured metadata feature and faced an
issue because they used previous schema versions (V11, V12) and they
were not aware that it was necessary to use V13 because the docs did not
cover it.

re: https://github.com/grafana/loki/issues/10683
---
 docs/sources/get-started/labels/structured-metadata.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/sources/get-started/labels/structured-metadata.md b/docs/sources/get-started/labels/structured-metadata.md
index 981142ad67..50a5acd320 100644
--- a/docs/sources/get-started/labels/structured-metadata.md
+++ b/docs/sources/get-started/labels/structured-metadata.md
@@ -9,6 +9,10 @@ description: Attaching metadata to logs.
 Structured metadata is an experimental feature and is subject to change in future releases of Grafana Loki. This feature is not yet available for Cloud Logs users.
 {{% /admonition %}}
 
+{{% admonition type="warning" %}}
+Structured metadata was added to chunk format V4 which is used if the schema version is greater or equal to `13`. (See [Schema Config]({{< relref "../../storage#schema-config" >}}) for more details about schema versions. )
+{{% /admonition %}}
+
 One of the powerful features of Loki is parsing logs at query time to extract metadata and build labels out of it.
 However, the parsing of logs at query time comes with a cost which can be significantly high for, as an example,
 large json blobs or a poorly written query using complex regex patterns.