diff --git a/README.md b/README.md
index 4f07ca6..fdbdf0e 100644
--- a/README.md
+++ b/README.md
@@ -38,6 +38,7 @@ the list of shows the bot should take screencaps from is read from a YAML file w
 ```yaml
 Char's Counterattack:
   path: /home/user/media/Gundam_CCA.mkv
+  weight: 2.5
 Gundam 0079:
   path: /home/user/media/Mobile Suit Gundam 0079/
   tags:
@@ -62,4 +63,6 @@ warnings on posts and in image alt text.  each show has two keys:
 - `parts`: an optional map of season numbers to season names.
   by default, if the bot detects episodes from multiple seasons in a directory,
   it will refer to them as "season [number]" in post CWs and image alt-text.
-  this is a map rather than a list, since show season numbers may be 1-indexed or 0-indexed.
\ No newline at end of file
+  this is a map rather than a list, since show season numbers may be 1-indexed or 0-indexed.
+- `weight`: an optional weight for this show in the random sampling of
+  shows. each show without a weight specified has a weight of `1.0`.