diff --git a/docs/_static/page.png b/docs/_static/page.png
new file mode 100644
index 0000000000..464caf278a
Binary files /dev/null and b/docs/_static/page.png differ
diff --git a/docs/_static/screenshots/smart_links_screenshot.png b/docs/_static/screenshots/smart_links_screenshot.png
new file mode 100644
index 0000000000..cc507d06fb
Binary files /dev/null and b/docs/_static/screenshots/smart_links_screenshot.png differ
diff --git a/docs/_static/smart_links_link.png b/docs/_static/smart_links_link.png
new file mode 100644
index 0000000000..ffee00f834
Binary files /dev/null and b/docs/_static/smart_links_link.png differ
diff --git a/docs/topics/smart_links.rst b/docs/topics/smart_links.rst
index 43e9002e10..031586792b 100644
--- a/docs/topics/smart_links.rst
+++ b/docs/topics/smart_links.rst
@@ -2,14 +2,23 @@
 Smart links
 ===========
 
-|Setup tab| |Right arrow| |Smart links button|
+To configure: |Setup tab| |Right arrow| |Smart links button|
+
+To use: |Document icon| |Right arrow| |Smart links link|
 
 Smart links are usefull for navigation between documents.  They are rule
 based but don't created any organizational structure just show the documents
 that match the rules as evaluated against the metadata of the currently
-displayed document.  The index is global, the smart links are dependant
+displayed document.  They are global, the smart links are dependant
 on the current document the user is viewing.
 
+.. figure:: /_static/screenshots/smart_links_screenshot.png
+   :alt: Smart links screenshot
+   :scale: 75%
+
+   Screenshot of smart links in action.  The documents being shown are from the same
+   permit file number as the current document being viewed by the user.
+   Notice how the current document is also highlighted with a black border.
 
 .. |Setup tab| image:: /_static/setup_tab.png
  :alt: Setup tab
@@ -22,3 +31,12 @@ on the current document the user is viewing.
 .. |Smart links button| image:: /_static/smart_links_button.png
  :alt: Smart links button
  :align: middle
+
+.. |Document icon| image:: /_static/page.png
+ :alt: Document icon
+ :align: middle
+
+.. |Smart links link| image:: /_static/smart_links_link.png
+ :alt: Smart links link
+ :align: middle
+