diff --git a/apps/formbricks-com/app/docs/link-surveys/embed-surveys/page.mdx b/apps/formbricks-com/app/docs/link-surveys/embed-surveys/page.mdx
new file mode 100644
index 0000000000..5ffff7c22e
--- /dev/null
+++ b/apps/formbricks-com/app/docs/link-surveys/embed-surveys/page.mdx
@@ -0,0 +1,81 @@
+import { TellaVideo } from "@/components/docs/TellaVideo";
+
+export const metadata = {
+ title: "Embed Surveys in Your Web Page",
+ description: "Embed Formbricks surveys seamlessly into your website or web application using an iframe.",
+};
+
+#### Embed Surveys
+
+# Embed Surveys in Your Web Page
+
+Embedding Formbricks surveys directly into your web pages allows you to integrate interactive surveys without redirecting users to a separate survey site. This method ensures a seamless integration and maintains the aesthetic continuity of your website or application.
+
+## How to Use it?
+
+
+
+1. Create and publish a link survey.
+
+2. Open survey summary page and click on **share** button on the top right.
+
+3. In the survey share modal, click on **Embed survey** button.
+
+4. Navigate to **Embed in a Web Page** tab and click on Copy code
+
+5. Paste the copied iframe code into the HTML of your web page where you want the survey to appear.
+
+### Example of Embedding a Survey
+
+
+
+
+```html
+
+
+
+```
+
+
+
+
+## Iframe Events
+
+The iframe fires a **formbricksSurveyCompleted** event when a user finishes a survey within the embedded iframe. This event can be captured through a message listener in your webpage's JavaScript
+
+### How to Use it?
+
+1. Embed the Formbricks survey on your webpage using the iframe method as described above.
+
+2. Add an event listener to your webpage’s JavaScript that listens for `message` events from the iframe.
+
+3. Check if the received message indicates that the survey is completed by comparing the `event.data` with the value `formbricksSurveyCompleted`.
+
+
+ It is important to verify the origin of the message to ensure it comes from the iframe containing your
+ survey, enhancing the security of your event handling.
+
+
+4. Implement your custom actions within the callback function based on the survey completion.
+
+### Example of Handling Survey Completion Events
+
+
+
+
+```javascript
+window.addEventListener("message", (event) => {
+ // Replace 'https://app.formbricks.com' with the actual web app url
+ if (event.origin === "https://app.formbricks.com" && event.data === "formbricksSurveyCompleted") {
+ console.log("Survey completed!");
+ // Implement your custom actions here
+ }
+});
+```
+
+
+
diff --git a/apps/formbricks-com/components/docs/Navigation.tsx b/apps/formbricks-com/components/docs/Navigation.tsx
index fd06cdcb5c..a7106beddd 100644
--- a/apps/formbricks-com/components/docs/Navigation.tsx
+++ b/apps/formbricks-com/components/docs/Navigation.tsx
@@ -210,6 +210,7 @@ export const navigation: Array = [
{ title: "Source Tracking", href: "/docs/link-surveys/source-tracking" },
{ title: "Hidden Fields", href: "/docs/link-surveys/hidden-fields" },
{ title: "Start At Question", href: "/docs/link-surveys/start-at-question" },
+ { title: "Embed Surveys", href: "/docs/link-surveys/embed-surveys" },
],
},
{
diff --git a/apps/formbricks-com/components/docs/TellaVideo.tsx b/apps/formbricks-com/components/docs/TellaVideo.tsx
new file mode 100644
index 0000000000..21d2b8c9ea
--- /dev/null
+++ b/apps/formbricks-com/components/docs/TellaVideo.tsx
@@ -0,0 +1,18 @@
+import React from "react";
+
+export function TellaVideo({ tellaVideoIdentifier }: { tellaVideoIdentifier: string }) {
+ return (
+
+
+
+ );
+}