diff --git a/editions/tw5.com/tiddlers/macros/tag-picker_Macro.tid b/editions/tw5.com/tiddlers/macros/tag-picker_Macro.tid
index eae5cf1b9..b2d9cb9f0 100644
--- a/editions/tw5.com/tiddlers/macros/tag-picker_Macro.tid
+++ b/editions/tw5.com/tiddlers/macros/tag-picker_Macro.tid
@@ -10,6 +10,6 @@ The <<.def tag-picker>> [[macro|Macros]] generates a combination of a text box a
 !! Parameters
 
 ;actions
-: Action widgets to be triggered when the pill is clicked
+: Action widgets to be triggered when the pill is clicked. Within the text, the variable ''tag'' contains the title of the selected tag.
 
 <<.macro-examples "tag-picker">>
diff --git a/editions/tw5.com/tiddlers/macros/tag-pill_Macro.tid b/editions/tw5.com/tiddlers/macros/tag-pill_Macro.tid
index e48206c71..73ea08058 100644
--- a/editions/tw5.com/tiddlers/macros/tag-pill_Macro.tid
+++ b/editions/tw5.com/tiddlers/macros/tag-pill_Macro.tid
@@ -16,6 +16,6 @@ The <<.def tag-pill>> [[macro|Macros]] generates a static tag pill showing a spe
 ;element-attributes
 : Additional attributes for the pill element
 ;actions
-: Action widgets to be triggered when the pill is clicked
+: Action widgets to be triggered when the pill is clicked. Within the text, the macro parameter ''tag'' contains the title of the selected tag.
 
 <<.macro-examples "tag-pill">>