diff --git a/docs/html-visualization-features.rst b/docs/html-visualization-features.rst
new file mode 100644
index 00000000..906d65ec
--- /dev/null
+++ b/docs/html-visualization-features.rst
@@ -0,0 +1,90 @@
+HTML Visualization Features
+===========================
+
+*Last updated 2021-10-08 with kmapper version 2.0.1*
+
+This page demonstrates some of the options available when using
+``kmapper.KeplerMapper.visualize`` to create KeplerMapper html visualizations.
+
+.. contents:: Contents
+ :local:
+
+
+Colors for samples and nodes
+----------------------------
+
+A set (or sets) of ``color_values`` associate values with samples. These values
+are mapped to a specified ``colorscale`` via min-max scaling. These mapped
+colorvalues are used for two things on the visualization:
+
+1. Histogram distributions
+
+ The "details" pane for a node displays a histogram distribution of that node's
+ samples' colorvalues.
+
+2. Node colors
+
+ Each node is assigned a color based on its samples' colorvalues.
+ ``node_color_function`` determines the assignation function.
+
+If more than one set of colorvalues or node color functions is specified, then
+dropdowns in the visualization allow toggling between them.
+
+.. image:: images/html-visualization-multiple-color-values-and-node-functions.gif
+ :width: 600
+
+
+Searchbar
+---------
+
+The searchbar can be used to highlight (i.e., visually resize) nodes based on
+whether their samples' ``custom_tooltips`` match a query. Currently, the
+searchbar can do three types of queries. See the docs for details.
+
+.. image:: images/html-visualization-search-bar.gif
+ :width: 600
+
+
+Min-intersection selector
+-------------------------
+
+Min-intersection, an argument passed to ``KeplerMapper.map``, is used to determine
+whether an edge should be drawn between pairs of nodes. The html visualization
+can dynamically change the min-intersection it uses to draw edges. Submitting a
+new value uses javascript to perform the same logic as is done in python in
+``.map``. The starting value for the html visualization is the value that was
+used to create the graph, which is read from metadata saved in the html file.
+
+.. image:: images/html-visualization-search-bar.gif
+ :width: 600
+
+
+Lock focus on and reposition nodes
+----------------------------------
+
+Normally, nodes are free to float around the visualization, acted upon by
+gravity and repulsion forces decided by the underlying d3-force simulation.
+However, clicking-and-dragging a node will cause that node to become "frozen" --
+it will stay where you drag it.
+
+Individual frozen nodes can be unfrozen, and all nodes can be unfrozen (or frozen) at once:
+
+.. image:: images/html-visualization-click-freeze-doubleclick-unfreeze.gif
+ :width: 600
+
+
+
+Nodes' positions and "frozen"-settings can saved to a ``.json`` config file. Node
+positions can be loaded from that file. Useful if the ``.html`` file and the ``.json``
+file to be stored and transferred in tandem, potentially for collaboration
+purposes.
+
+.. image:: images/html-visualization-save-and-reload.gif
+ :width: 600
+
+
+Light and dark modes
+--------------------
+
+The visualization can be changed to a white background which may be better for
+printing.
diff --git a/docs/images/html-visualization-click-freeze-doubleclick-unfreeze.gif b/docs/images/html-visualization-click-freeze-doubleclick-unfreeze.gif
new file mode 100644
index 00000000..606e6d41
Binary files /dev/null and b/docs/images/html-visualization-click-freeze-doubleclick-unfreeze.gif differ
diff --git a/docs/images/html-visualization-min-intersection-selector.gif b/docs/images/html-visualization-min-intersection-selector.gif
new file mode 100644
index 00000000..d2cb8a8b
Binary files /dev/null and b/docs/images/html-visualization-min-intersection-selector.gif differ
diff --git a/docs/images/html-visualization-multiple-color-values-and-node-functions.gif b/docs/images/html-visualization-multiple-color-values-and-node-functions.gif
new file mode 100644
index 00000000..e324fbea
Binary files /dev/null and b/docs/images/html-visualization-multiple-color-values-and-node-functions.gif differ
diff --git a/docs/images/html-visualization-save-and-reload.gif b/docs/images/html-visualization-save-and-reload.gif
new file mode 100644
index 00000000..97371470
Binary files /dev/null and b/docs/images/html-visualization-save-and-reload.gif differ
diff --git a/docs/images/html-visualization-search-bar.gif b/docs/images/html-visualization-search-bar.gif
new file mode 100644
index 00000000..a14d153c
Binary files /dev/null and b/docs/images/html-visualization-search-bar.gif differ
diff --git a/docs/tutorials.rst b/docs/tutorials.rst
index af72c088..6f290e21 100644
--- a/docs/tutorials.rst
+++ b/docs/tutorials.rst
@@ -6,6 +6,7 @@ These pages demonstrate using KeplerMapper in various ways.
.. toctree::
:maxdepth: 1
+ html-visualization-features
Visualization Adapters
notebooks/Plotly-Demo
Choosing a Lens