diff --git a/index.html b/index.html
index 247815f29..50f08488b 100644
--- a/index.html
+++ b/index.html
@@ -338,18 +338,15 @@ in any specification.</span></p>
               }
             </style>
             <h4 data-type="Explanation">Explanation</h4>
-
-            <!-- Use a step-by-step (ordered) list if possible. Keep it concise. -->
-            <p>Bla bla bla</p>
+            <p>Declare variable with <code>--variable-name:</code>.</p>
+            <p>Reuse declared variable throughout the document using the <code>var(--variable-name)</code> function.</p>
             <h4 data-type="Browser support">Browser support</h4>
             <div>
               <div class="snippet__browser-support">
                 100%
               </div>
             </div>
-
-            <!-- Use the checkmark or the warning emoji, see the existing snippets. -->
-            <p><span class="snippet__support-note">✅ No caveats.</span></p>
+            <p><span class="snippet__support-note">⚠️ This is an experimental technology.</span></p>
 
             <!-- Whenever possible, link a `caniuse` feature which allows the browser support percentage to be displayed.
 If no link is provided, it defaults to 99+%. -->
diff --git a/snippets/custom-variables.md b/snippets/custom-variables.md
index 6c9b458a0..be23b00c1 100644
--- a/snippets/custom-variables.md
+++ b/snippets/custom-variables.md
@@ -44,14 +44,13 @@ CSS variables that contain specific values to be reused throughout a document.
 
 #### Explanation
 
-<!-- Use a step-by-step (ordered) list if possible. Keep it concise. -->
-Bla bla bla
+Declare variable with `--variable-name:`.
+
+Reuse declared variable throughout the document using the `var(--variable-name)` function.
 
 #### Browser support
 
-<!-- Use the checkmark or the warning emoji, see the existing snippets. -->
-
-<span class="snippet__support-note">✅ No caveats.</span>
+<span class="snippet__support-note">⚠️ This is an experimental technology.</span>
 
 <!-- Whenever possible, link a `caniuse` feature which allows the browser support percentage to be displayed.
 If no link is provided, it defaults to 99+%. -->