diff --git a/docs/blacklist.md b/docs/blacklist.md
index b854c07..6fede63 100644
--- a/docs/blacklist.md
+++ b/docs/blacklist.md
@@ -4,6 +4,8 @@ title: Blacklist
# Blacklist
+## Blacklist
+
The blacklist allows you to disable the plugin for certain pages by URL patterns.
For instance, you could use `"*.slack.com"` to disable the plugin on all Slack channels.
In addition, you can also specify path patterns, such as `"example.com/mail/*"`.
@@ -19,3 +21,20 @@ In addition, you can also specify path patterns, such as `"example.com/mail/*"`.
You can toggle Vim Vixen between disabled and enabled with
shift+Esc.
+
+## Partial Blacklist
+
+The partial blacklist disables certain keys for each webpage separately.
+This is enabled by describing object with `"url"` and `"keys"` instead of a string in the blacklist.
+To disable j and k keys (scroll down and up) on github.com as an example, describe target url and disabled keys as the following:
+
+```json
+{
+ "blacklist" [
+ { "url": "github.com", "keys": ["j", "k"] }
+ ]
+}
+```
+
+The partial blacklist blocks all operations starting with the keys but not exactly-matched.
+That means if the g described in "keys" field, it block all operation starting with g, such as gg, gt, and gT.