diff --git a/README.md b/README.md
index 7bc946375..3488787d0 100644
--- a/README.md
+++ b/README.md
@@ -1304,7 +1304,9 @@ Optionally included keys are:
 * `metadata`
 
 	This is a generic metadata string. The metadata will be written to the bottom of
-	metadata files within `/path/to/recording_dir/metadata/`. This can be used to
+	metadata files within `/path/to/recording_dir/metadata/` or to
+	`recording_metakeys` table.  In the latter case, `metadata` string must
+	contain a list of `key:val` pairs separated by `|` character.  `metadata` can be used to
 	record additional information about recorded calls. `metadata` values passed in
 	through subsequent messages will overwrite previous metadata values.