diff --git a/docs/source/permalinks.rst b/docs/source/permalinks.rst
index b1ceeaf..97dbcd2 100644
--- a/docs/source/permalinks.rst
+++ b/docs/source/permalinks.rst
@@ -6,11 +6,19 @@ Permalinks
 Usage
 ------------
 
+To get a secure Share link, click the Share icon on the map:
+
  .. image:: images/Permalink-1.png
 
+ Copy the url
+
  .. image:: images/Permalink-4.png
 
+ By default, links are good for one day and one use.
+
  .. image:: images/Permalinks-2.png
 
+ To change this for your link, go to Permalinks
+
  .. image:: images/Permalinks-3.png