diff --git a/website/docs/source/layouts/layout.erb b/website/docs/source/layouts/layout.erb
index ed9b866f9..76d71b90e 100644
--- a/website/docs/source/layouts/layout.erb
+++ b/website/docs/source/layouts/layout.erb
@@ -135,6 +135,7 @@
>SSH Sharing
>vagrant connect
>Security
+ >Custom Provider
<% end %>
diff --git a/website/docs/source/v2/share/provider.html.md b/website/docs/source/v2/share/provider.html.md
new file mode 100644
index 000000000..d97b7144f
--- /dev/null
+++ b/website/docs/source/v2/share/provider.html.md
@@ -0,0 +1,26 @@
+---
+page_title: "Custom Provider - Vagrant Share"
+sidebar_current: "share-provider"
+---
+
+# Custom Provider
+
+
+
+ Warning: Advanced Topic! This topic is related to
+ developing Vagrant plugins. If you're not interested in this or
+ you're just starting with Vagrant, it is safe to skip this page.
+
+
+
+If you're developing a [custom provider](/v2/plugins/providers.html), you'll
+need to do a tiny bit more work in order for it to work well with Vagrant
+Share.
+
+For now, this is only one step:
+
+ * `public_address` provider capability - You must implement this capability
+ to return a string that is an address that can be used to access the
+ guest from Vagrant. This does not need to be a globally routable address,
+ it only needs to be accessible from the machine running Vagrant. If you
+ can't detect an address, return `nil`.
diff --git a/website/docs/source/v2/share/security.html.md b/website/docs/source/v2/share/security.html.md
index 6be70e620..552425230 100644
--- a/website/docs/source/v2/share/security.html.md
+++ b/website/docs/source/v2/share/security.html.md
@@ -26,7 +26,7 @@ In addition to these options, there are other features we've built to help:
are encrypted through the various proxies and only unencrypted during the final
local communication between the local proxy and the Vagrant environment.
- * Share names, such as happy-panda-1234, are randoly chosen from a pool
+ * Share names, such as happy-panda-1234, are randomly chosen from a pool
of over 40,000,000 possible names. And we're routinely adding more
words to grow this pool. It is unlikely that anyone will guess your
share name.