diff --git a/docs/docs.md b/docs/docs.md
index 5c3c848c..6e676808 100644
--- a/docs/docs.md
+++ b/docs/docs.md
@@ -21,6 +21,7 @@
 ### More questions?
 
 * [Frequently Asked Question](/faq)
+* [Embedding project](/embed)
 * [Help Translate](/translate)
 * [Release notes](/release-notes)
 
diff --git a/docs/embed.md b/docs/embed.md
new file mode 100644
index 00000000..5aafad05
--- /dev/null
+++ b/docs/embed.md
@@ -0,0 +1,27 @@
+# Embed your project
+
+Once you have a cool project, it is possible to save it in the cloud and share it or embed it to your web site.
+
+### Instructions
+
+* Click on **More..**, **Embed Project...**
+* Click on the **Publish** button
+
+The embed dialog will provide you with various options to embed your project in your web site.
+
+### Project URL
+
+This URL will point to a web page that contains that project.
+
+* see the "happy" project: https://codethemicrobit.com/pyirlbpsei
+
+### ~hint
+
+**Developers:** This page supports OEmbed as well 
+
+### ~
+
+### Embedding into a blog or web site
+
+* Copy the HTML and paste it into your HTML source.
+
diff --git a/docs/faq.md b/docs/faq.md
index 758bf860..a0cd14ea 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -18,7 +18,8 @@ to reopen your latest project. You can also open previous project stored locally
 
 The project source is also stored in each compiled ``.hex`` file. Drag and drop the ``.hex`` file into the web editor to load the project.
 
-To share your project with others, you can use the **Embed** feature. It stores your project in the cloud and creates a URL that you can share with others.
+To share your project with others, you can use the [Embed Project...](/embed). 
+It stores your project in the cloud and creates a URL that you can share with others.
 
 If you are using [Visual Studio Code](/code), all your programs are stored as files on your computer and you can use your favorite source control system as needed.