diff --git a/templates/shortcodes/image_toggler.html b/templates/shortcodes/image_toggler.html
index 09fca1a..6a64995 100644
--- a/templates/shortcodes/image_toggler.html
+++ b/templates/shortcodes/image_toggler.html
@@ -1,3 +1,6 @@
+{# The `random_id` ensures that each instance of the shortcode has a "unique" id #}
+{# allowing individual interactive elements (like toggles) to function correctly. #}
+{# This avoids conflicts when multiple instances of the shortcode are used. #}
 {%- set random_id = get_random(end=100000) -%}
 
 {% set default_meta = get_image_metadata(path=default_src, allow_missing=true) %}
diff --git a/templates/shortcodes/multilingual_quote.html b/templates/shortcodes/multilingual_quote.html
index 556bd1d..dda2484 100644
--- a/templates/shortcodes/multilingual_quote.html
+++ b/templates/shortcodes/multilingual_quote.html
@@ -6,6 +6,10 @@
     {%- set close_quote = "”" -%}
 {%- endif -%}
 
+{# The `random_id` ensures that each instance of the shortcode has a "unique" id #}
+{# allowing individual interactive elements (like toggles) to function correctly. #}
+{# This avoids conflicts when multiple instances of the shortcode are used. #}
+{# More context: https://github.com/welpo/tabi/issues/82 #}
 {%- set random_id = get_random(end=100000) -%}
 
 <div class="quote-container">