diff --git a/docs/documentation/rest.asciidoc b/docs/documentation/rest.asciidoc
index c5a7e3215..43f9818ed 100644
--- a/docs/documentation/rest.asciidoc
+++ b/docs/documentation/rest.asciidoc
@@ -386,6 +386,15 @@ Those columns can be used for filtering or to only select specific custom values
 ]
 ------
 
+[TIP]
+.Host custom variables
+=======
+Host custom variables are accessible with the _HOST prefix for example like.:
+
+`%> thruk r '/services?columns=_HOSTWORKER&description'`
+=======
+
+
 == Functions
 
 === Transformation Functions