code · pull · Aug 30, 2026 · Aug 30, 2026 · Aug 30, 2026 · Aug 30, 2026
diff --git a/docs/images/surveys/best-practices/cancel-subscription/change-text.webp b/docs/images/surveys/best-practices/cancel-subscription/change-text.webp
diff --git a/docs/images/surveys/best-practices/cancel-subscription/create-cancel-flow.webp b/docs/images/surveys/best-practices/cancel-subscription/create-cancel-flow.webp
diff --git a/docs/images/surveys/best-practices/cancel-subscription/publish-survey.webp b/docs/images/surveys/best-practices/cancel-subscription/publish-survey.webp
diff --git a/docs/images/surveys/best-practices/cancel-subscription/recontact-options.webp b/docs/images/surveys/best-practices/cancel-subscription/recontact-options.webp
diff --git a/docs/images/surveys/best-practices/cancel-subscription/select-action.webp b/docs/images/surveys/best-practices/cancel-subscription/select-action.webp
diff --git a/docs/images/surveys/best-practices/cancel-subscription/template.webp b/docs/images/surveys/best-practices/cancel-subscription/template.webp
diff --git a/docs/images/surveys/best-practices/cancel-subscription/trigger-css-selector.webp b/docs/images/surveys/best-practices/cancel-subscription/trigger-css-selector.webp
diff --git a/docs/images/surveys/best-practices/cancel-subscription/trigger-inner-text.webp b/docs/images/surveys/best-practices/cancel-subscription/trigger-inner-text.webp
diff --git a/docs/images/surveys/best-practices/cancel-subscription/trigger-page-url.webp b/docs/images/surveys/best-practices/cancel-subscription/trigger-page-url.webp
diff --git a/docs/images/surveys/best-practices/cancel-subscription/trigger.webp b/docs/images/surveys/best-practices/cancel-subscription/trigger.webp
diff --git a/docs/images/surveys/best-practices/contact-form/add-question.webp b/docs/images/surveys/best-practices/contact-form/add-question.webp
diff --git a/docs/images/surveys/best-practices/contact-form/email-field.webp b/docs/images/surveys/best-practices/contact-form/email-field.webp
diff --git a/docs/images/surveys/best-practices/contact-form/embed.webp b/docs/images/surveys/best-practices/contact-form/embed.webp
diff --git a/docs/images/surveys/best-practices/contact-form/message-field.webp b/docs/images/surveys/best-practices/contact-form/message-field.webp
diff --git a/docs/images/surveys/best-practices/contact-form/name-field.webp b/docs/images/surveys/best-practices/contact-form/name-field.webp
diff --git a/docs/images/surveys/best-practices/contact-form/query-form.webp b/docs/images/surveys/best-practices/contact-form/query-form.webp
diff --git a/docs/images/surveys/best-practices/contact-form/single-select-questionare.webp b/docs/images/surveys/best-practices/contact-form/single-select-questionare.webp
diff --git a/docs/images/surveys/best-practices/contact-form/welcome1.webp b/docs/images/surveys/best-practices/contact-form/welcome1.webp
diff --git a/docs/images/surveys/best-practices/docs-feedback/add-action.webp b/docs/images/surveys/best-practices/docs-feedback/add-action.webp
diff --git a/docs/images/surveys/best-practices/docs-feedback/change-id.webp b/docs/images/surveys/best-practices/docs-feedback/change-id.webp
diff --git a/docs/images/surveys/best-practices/docs-feedback/copy-ids.webp b/docs/images/surveys/best-practices/docs-feedback/copy-ids.webp
diff --git a/docs/images/surveys/best-practices/docs-feedback/docs-template.webp b/docs/images/surveys/best-practices/docs-feedback/docs-template.webp
diff --git a/docs/images/surveys/best-practices/docs-feedback/select-action.webp b/docs/images/surveys/best-practices/docs-feedback/select-action.webp
diff --git a/docs/images/surveys/best-practices/docs-feedback/survey-trigger.webp b/docs/images/surveys/best-practices/docs-feedback/survey-trigger.webp
diff --git a/docs/images/surveys/best-practices/feature-chaser/action-css.webp b/docs/images/surveys/best-practices/feature-chaser/action-css.webp
diff --git a/docs/images/surveys/best-practices/feature-chaser/action-innertext.webp b/docs/images/surveys/best-practices/feature-chaser/action-innertext.webp
diff --git a/docs/images/surveys/best-practices/feature-chaser/change-text.webp b/docs/images/surveys/best-practices/feature-chaser/change-text.webp
diff --git a/docs/images/surveys/best-practices/feature-chaser/create-survey.webp b/docs/images/surveys/best-practices/feature-chaser/create-survey.webp
diff --git a/docs/images/surveys/best-practices/feature-chaser/publish.webp b/docs/images/surveys/best-practices/feature-chaser/publish.webp
diff --git a/docs/images/surveys/best-practices/feature-chaser/recontact-options.webp b/docs/images/surveys/best-practices/feature-chaser/recontact-options.webp
diff --git a/docs/images/surveys/best-practices/feature-chaser/select-action.webp b/docs/images/surveys/best-practices/feature-chaser/select-action.webp
diff --git a/docs/images/surveys/best-practices/feature-chaser/template.webp b/docs/images/surveys/best-practices/feature-chaser/template.webp
diff --git a/docs/images/surveys/best-practices/feature-chaser/trigger.webp b/docs/images/surveys/best-practices/feature-chaser/trigger.webp
diff --git a/docs/images/surveys/best-practices/improve-email-content/choose-survey-type.webp b/docs/images/surveys/best-practices/improve-email-content/choose-survey-type.webp
diff --git a/docs/images/surveys/best-practices/improve-email-content/email-embed.webp b/docs/images/surveys/best-practices/improve-email-content/email-embed.webp
diff --git a/...rveys/best-practices/improve-email-content/embed-survey-code-in-your-email.webp b/...rveys/best-practices/improve-email-content/embed-survey-code-in-your-email.webp
diff --git a/docs/images/surveys/best-practices/improve-email-content/embed-survey-prompt.webp b/docs/images/surveys/best-practices/improve-email-content/embed-survey-prompt.webp
diff --git a/...actices/improve-email-content/improve-newsletter-content-editor-formbricks.webp b/...actices/improve-email-content/improve-newsletter-content-editor-formbricks.webp
diff --git a/...practices/improve-email-content/improve-newsletter-content-survey-location.webp b/...practices/improve-email-content/improve-newsletter-content-survey-location.webp
diff --git a/docs/images/surveys/best-practices/improve-email-content/template.webp b/docs/images/surveys/best-practices/improve-email-content/template.webp
diff --git a/docs/images/surveys/best-practices/improve-trial-cr/action-innertext.webp b/docs/images/surveys/best-practices/improve-trial-cr/action-innertext.webp
diff --git a/docs/images/surveys/best-practices/improve-trial-cr/action-pageurl.webp b/docs/images/surveys/best-practices/improve-trial-cr/action-pageurl.webp
diff --git a/docs/images/surveys/best-practices/improve-trial-cr/change-text.webp b/docs/images/surveys/best-practices/improve-trial-cr/change-text.webp
diff --git a/docs/images/surveys/best-practices/improve-trial-cr/create-survey.webp b/docs/images/surveys/best-practices/improve-trial-cr/create-survey.webp
diff --git a/docs/images/surveys/best-practices/improve-trial-cr/publish.webp b/docs/images/surveys/best-practices/improve-trial-cr/publish.webp
diff --git a/docs/images/surveys/best-practices/improve-trial-cr/recontact-options.webp b/docs/images/surveys/best-practices/improve-trial-cr/recontact-options.webp
diff --git a/docs/images/surveys/best-practices/improve-trial-cr/select-action.webp b/docs/images/surveys/best-practices/improve-trial-cr/select-action.webp
diff --git a/docs/images/surveys/best-practices/improve-trial-cr/template.webp b/docs/images/surveys/best-practices/improve-trial-cr/template.webp
diff --git a/docs/images/surveys/best-practices/improve-trial-cr/trigger.webp b/docs/images/surveys/best-practices/improve-trial-cr/trigger.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/action-css.webp b/docs/images/surveys/best-practices/interview-prompt/action-css.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/action-innertext.webp b/docs/images/surveys/best-practices/interview-prompt/action-innertext.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/action-pageurl.webp b/docs/images/surveys/best-practices/interview-prompt/action-pageurl.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/add-action.webp b/docs/images/surveys/best-practices/interview-prompt/add-action.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/change-text.webp b/docs/images/surveys/best-practices/interview-prompt/change-text.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/create-prompt.webp b/docs/images/surveys/best-practices/interview-prompt/create-prompt.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/interview-example.webp b/docs/images/surveys/best-practices/interview-prompt/interview-example.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/publish-survey.webp b/docs/images/surveys/best-practices/interview-prompt/publish-survey.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/recontact-options.webp b/docs/images/surveys/best-practices/interview-prompt/recontact-options.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/select-action.webp b/docs/images/surveys/best-practices/interview-prompt/select-action.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/template.webp b/docs/images/surveys/best-practices/interview-prompt/template.webp
diff --git a/docs/images/surveys/best-practices/interview-prompt/trigger.webp b/docs/images/surveys/best-practices/interview-prompt/trigger.webp
diff --git a/docs/images/surveys/best-practices/panel-management/download-responses.webp b/docs/images/surveys/best-practices/panel-management/download-responses.webp
diff --git a/docs/images/surveys/best-practices/pmf-survey/action-css.webp b/docs/images/surveys/best-practices/pmf-survey/action-css.webp
diff --git a/docs/images/surveys/best-practices/pmf-survey/action-pageurl.webp b/docs/images/surveys/best-practices/pmf-survey/action-pageurl.webp
diff --git a/docs/images/surveys/best-practices/pmf-survey/change-text.webp b/docs/images/surveys/best-practices/pmf-survey/change-text.webp
diff --git a/docs/images/surveys/best-practices/pmf-survey/create-survey.webp b/docs/images/surveys/best-practices/pmf-survey/create-survey.webp
diff --git a/docs/images/surveys/best-practices/pmf-survey/publish.webp b/docs/images/surveys/best-practices/pmf-survey/publish.webp
diff --git a/docs/images/surveys/best-practices/pmf-survey/recontact-options.webp b/docs/images/surveys/best-practices/pmf-survey/recontact-options.webp
diff --git a/docs/images/surveys/best-practices/pmf-survey/select-action.webp b/docs/images/surveys/best-practices/pmf-survey/select-action.webp
diff --git a/docs/images/surveys/best-practices/pmf-survey/template.webp b/docs/images/surveys/best-practices/pmf-survey/template.webp
diff --git a/docs/images/surveys/best-practices/pmf-survey/trigger.webp b/docs/images/surveys/best-practices/pmf-survey/trigger.webp
diff --git a/docs/images/surveys/best-practices/research-panel/download.webp b/docs/images/surveys/best-practices/research-panel/download.webp
diff --git a/docs/platform/features/integrations/activepieces.mdx b/docs/platform/features/integrations/activepieces.mdx
@@ -1,6 +1,7 @@
 ---
 title: "Activepieces"
 description: "A step-by-step guide to integrating Formbricks with Activepieces."
+icon: "puzzle-piece"
 ---
 
 Activepieces is a versatile tool to automate workflows between Formbricks and numerous applications. Here's how to set it up.
@@ -15,7 +16,7 @@ Set up the `questionId`s of your survey questions before publishing.
 
 ![Update Question ID](/images/platform/features/integrations/activepieces/update-question-id.webp)
 
-_Update the Question ID field in every question card under Advanced Settings._
+_Update the Question ID on every question — it is the first field behind **Show Question settings** at the foot of a question card._
 
 <Note>
   Already published? Duplicate survey You can only update the questionId before publishing the survey. If already published, simply duplicate it.
@@ -38,7 +39,7 @@ Click on `Create connection`:
 
 ![Create Connection](/images/platform/features/integrations/activepieces/create-connection.webp)
 
-Enter the Formbricks API Host and API Key. API Host is by default set to https://app.formbricks.com but can be modified for self-hosting instances. Learn how to get an API Key from the [API Key tutorial](/api-reference/rest-api#how-to-generate-an-api-key).
+Enter the Formbricks API Host and API Key. API Host is by default set to https://app.formbricks.com but can be modified for self-hosting instances. Learn how to get an API Key from the [API Key tutorial](/api-reference/generate-key).
 
 ![Configure Connection](/images/platform/features/integrations/activepieces/configure-connection.webp)
 

diff --git a/docs/platform/features/integrations/airtable.mdx b/docs/platform/features/integrations/airtable.mdx
@@ -1,6 +1,7 @@
 ---
 title: "Airtable"
 description: "A step-by-step guide to integrate Airtable with Formbricks Cloud."
+icon: "table"
 ---
 
 The Airtable integration allows you to automatically send responses to an Airtable of your choice.

diff --git a/docs/platform/features/integrations/google-sheets.mdx b/docs/platform/features/integrations/google-sheets.mdx
@@ -1,6 +1,7 @@
 ---
 title: "Google Sheets"
 description: "The Google Sheets integration allows you to automatically send responses to a Google Sheet of your choice."
+icon: "file-spreadsheet"
 ---
 
 <Note>

diff --git a/docs/platform/features/integrations/hubspot.mdx b/docs/platform/features/integrations/hubspot.mdx
@@ -1,6 +1,7 @@
 ---
 title: "HubSpot"
 description: "Learn how to integrate Formbricks with HubSpot to automatically create or update contacts when survey responses are submitted."
+icon: "hubspot"
 ---
 
 <Note>
@@ -69,7 +70,7 @@ To create a Legacy Private App:
     ![Search Formbricks](/images/platform/features/integrations/make/search-formbricks.webp)
   </Step>
   <Step title="Connect Formbricks to Make">
-    Click **Create a webhook**, enter your Formbricks API Host (default: `https://app.formbricks.com`), add your Formbricks API Key (see [API Key Setup](/api-reference/rest-api#how-to-generate-an-api-key)), and select the survey you want to connect.
+    Click **Create a webhook**, enter your Formbricks API Host (default: `https://app.formbricks.com`), add your Formbricks API Key (see [API Key Setup](/api-reference/generate-key)), and select the survey you want to connect.
 
     ![Enter API Key](/images/platform/features/integrations/make/enter-api-key-and-host.webp)
   </Step>

diff --git a/docs/platform/features/integrations/make.mdx b/docs/platform/features/integrations/make.mdx
@@ -2,6 +2,7 @@
 title: "Make"
 description:
   "Discover how to seamlessly integrate Formbricks with Make.com. Dive into our comprehensive guide to set up scenarios, connect with a plethora of apps, and send your survey data to more than 1000 platforms."
+icon: "circle-nodes"
 ---
 
 Make is a powerful tool to send information between Formbricks and thousands of apps. Here's how to set it up.
@@ -16,7 +17,7 @@ Set up the `questionId`s of your survey questions before publishing.
 
 ![Update Question ID](/images/platform/features/integrations/make/update-question-id.webp)
 
-*Update the Question ID field in every question card under Advanced Settings.*
+*Update the Question ID on every question — it is the first field behind **Show Question settings** at the foot of a question card.*
 
 <Note>
   Already published? Duplicate survey You can only update the questionId
@@ -44,7 +45,7 @@ Click "Create a webhook":
 
 ![Create Webhook](/images/platform/features/integrations/make/create-webhook.webp)
 
-Enter the Formbricks API Host and API Key. API Host is by default set to [https://app.formbricks.com](https://app.formbricks.com) but can be modified for self-hosting instances. Learn how to get an API Key from the [API Key tutorial](/api-reference/rest-api#how-to-generate-an-api-key).
+Enter the Formbricks API Host and API Key. API Host is by default set to [https://app.formbricks.com](https://app.formbricks.com) but can be modified for self-hosting instances. Learn how to get an API Key from the [API Key tutorial](/api-reference/generate-key).
 
 ![Enter API Key](/images/platform/features/integrations/make/enter-api-key-and-host.webp)
 

diff --git a/docs/platform/features/integrations/n8n.mdx b/docs/platform/features/integrations/n8n.mdx
@@ -1,6 +1,7 @@
 ---
 title: "n8n"
 description: "Integrate Formbricks with n8n for a streamlined workflow experience."
+icon: "diagram-project"
 ---
 
 <Note>
@@ -23,7 +24,7 @@ When setting up the node your life will be easier when you change the `questionI
 
 ![Update Question ID](/images/platform/features/integrations/n8n/update-question-id.webp)
 
-*In every question card in the Advanced Settings you find the Question ID field. Update it so that you'll recognize the response tied to this question.*
+*The Question ID is the first field behind **Show Question settings** at the foot of a question card. Update it so you will recognise the response tied to this question.*
 
 <Note>
   Already published? Duplicate survey You can only update the questionId
@@ -48,7 +49,7 @@ Click on Create New Credential button to add your host and API Key
 
 ![Add host and api key](/images/platform/features/integrations/n8n/add-api-key.webp)
 
-Now you need an API key. Please refer to the [API Key Setup](/api-reference/rest-api#how-to-generate-an-api-key) page to learn how to create one.
+Now you need an API key. Please refer to the [API Key Setup](/api-reference/generate-key) page to learn how to create one.
 
 Once you copied it in the API Key field, hit Save button to test the connection and save the credentials.
 

diff --git a/docs/platform/features/integrations/notion.mdx b/docs/platform/features/integrations/notion.mdx
@@ -1,6 +1,7 @@
 ---
 title: "Notion"
 description: "The notion integration allows you to automatically send responses to a Notion database of your choice."
+icon: "book"
 ---
 
 <Note>

diff --git a/docs/platform/features/integrations/overview.mdx b/docs/platform/features/integrations/overview.mdx
@@ -1,6 +1,7 @@
 ---
 title: "Third-party Integrations"
 description: "Configure third-party integrations with Formbricks Cloud."
+icon: "bridge"
 ---
 
 At Formbricks, we understand the importance of integrating with third-party applications. We have step-by-step guides to configure our third-party integrations with Formbricks Cloud.&#x20;

diff --git a/docs/platform/features/integrations/slack.mdx b/docs/platform/features/integrations/slack.mdx
@@ -2,6 +2,7 @@
 title: "Slack"
 description:
   "The slack integration allows you to automatically send responses to a Slack channel of your choice."
+icon: "slack"
 ---
 
 <Note>

diff --git a/docs/platform/features/integrations/webhooks.mdx b/docs/platform/features/integrations/webhooks.mdx
@@ -1,6 +1,7 @@
 ---
 title: "Webhooks"
 description: "With webhooks, you can receive real-time HTTP notifications when specific objects change in your Formbricks environment. This allows you to stay updated and trigger automated actions based on these events."
+icon: "webhook"
 ---
 
 ### **Webhook Triggers**

diff --git a/docs/platform/features/integrations/wordpress.mdx b/docs/platform/features/integrations/wordpress.mdx
@@ -1,6 +1,7 @@
 ---
 title: "Wordpress"
 description: "Target specific visitors with a survey on your WordPress page using Formbricks for free. Show survey on specific page or on button click."
+icon: "wordpress"
 ---
 
 To run a targeted survey on your WordPress website, Formbricks is the way to go!&#x20;

diff --git a/docs/platform/features/integrations/zapier.mdx b/docs/platform/features/integrations/zapier.mdx
@@ -1,6 +1,7 @@
 ---
 title: "Zapier"
 description: "Master the integration of Formbricks with Zapier using our detailed guide. Seamlessly connect your surveys to 5000+ apps, automate data transfers, and enhance feedback management. Start optimizing your workflow today."
+icon: "bolt"
 ---
 
 <Note>
@@ -13,7 +14,7 @@ When setting up the Zap your life will be easier when you change the `questionId
 
 ![Update Question ID](/images/platform/features/integrations/zapier/update-question-id.webp)
 
-*In every question card in the Advanced Settings you find the Question ID field. Update it so that you’ll recognize the response tied to this question.*
+*The Question ID is the first field behind **Show Question settings** at the foot of a question card. Update it so you will recognise the response tied to this question.*
 
 <Note>
   Already published? Duplicate survey You can only update the questionId
@@ -46,7 +47,7 @@ Now, you have to connect Zapier with Formbricks via an API Key:
 
 ![Connect with Formbricks - 2](/images/platform/features/integrations/zapier/connect-with-formbricks-2.webp)
 
-Now you need an API key. Please refer to the [API Key Setup](/api-reference/rest-api#how-to-generate-an-api-key) page to learn how to create one.
+Now you need an API key. Please refer to the [API Key Setup](/api-reference/generate-key) page to learn how to create one.
 
 Once you copied it in the newly opened Zapier window, you will be connected:
 

diff --git a/docs/self-hosting/advanced/enterprise-features/saml-sso.mdx b/docs/self-hosting/advanced/enterprise-features/saml-sso.mdx
@@ -4,4 +4,9 @@ description: "Configure Single Sign-On with SAML for your Formbricks instance."
 icon: "key"
 ---
 
-Implement enterprise-grade authentication for your survey platform using [SAML SSO](/self-hosting/configuration/auth-sso/saml-sso#saml-sso).
+<Note>
+  Single Sign-On is part of the Formbricks [Enterprise Edition](/self-hosting/advanced/license). SAML
+  additionally requires the `saml` entitlement on the licence.
+</Note>
+
+Implement enterprise-grade authentication for your survey platform using [SAML SSO](/self-hosting/configuration/auth-sso/saml-sso).
diff --git a/docs/self-hosting/configuration/integrations/activepieces.mdx b/docs/self-hosting/configuration/integrations/activepieces.mdx
@@ -1,6 +1,7 @@
 ---
 title: ActivePieces (On Premise)
 description: Learn how to configure ActivePieces integration in your survey for self-hosting instance.
+icon: "puzzle-piece"
 ---
 
 ## Setting Up ActivePieces with Self-Hosted Formbricks

diff --git a/docs/self-hosting/configuration/integrations/airtable.mdx b/docs/self-hosting/configuration/integrations/airtable.mdx
@@ -1,6 +1,7 @@
 ---
 title: Airtable (On Premise)
 description: Instantly populate your Airtable table with survey data
+icon: "table"
 ---
 
 The Airtable integration allows you to automatically send responses to an Airtable of your choice.

diff --git a/docs/self-hosting/configuration/integrations/google-sheets.mdx b/docs/self-hosting/configuration/integrations/google-sheets.mdx
@@ -1,6 +1,7 @@
 ---
 title: Google Sheets (On Premise)
 description: Instantly populate your Google Sheet table with survey data
+icon: "file-spreadsheet"
 ---
 
 The Google Sheets integration allows you to automatically send responses to an Google Sheets of your choice.

diff --git a/docs/self-hosting/configuration/integrations/n8n.mdx b/docs/self-hosting/configuration/integrations/n8n.mdx
@@ -1,6 +1,7 @@
 ---
 title: n8n (On Premise)
 description: Set up automations with your self-hosted n8n instance.
+icon: "diagram-project"
 ---
 
 The n8n integration allows you to create automations based on survey responses.
@@ -28,7 +29,7 @@ Enabling the n8n integration in a self-hosted environment requires a new workflo
 
 ![AddAPIKey](https://res.cloudinary.com/dwdb9tvii/image/upload/v1738252907/image_a1fmyc.jpg)
 
-Now you need an API key. Please refer to the [API Key Setup](/api-reference/rest-api#how-to-generate-an-api-key) page to learn how to create one.
+Now you need an API key. Please refer to the [API Key Setup](/api-reference/generate-key) page to learn how to create one.
 
 Once you copied it in the API Key field, hit Save button to test the connection and save the credentials.
 

diff --git a/docs/self-hosting/configuration/integrations/notion.mdx b/docs/self-hosting/configuration/integrations/notion.mdx
@@ -1,6 +1,7 @@
 ---
 title: Notion (On Premise)
 description: Instantly populate a Notion database with survey data
+icon: "book"
 ---
 
 The Notion integration allows you to automatically send responses to a Notion database of your choice.

diff --git a/docs/self-hosting/configuration/integrations/slack.mdx b/docs/self-hosting/configuration/integrations/slack.mdx
@@ -1,6 +1,7 @@
 ---
 title: Slack (On Premise)
 description: Send survey responses automatically to Slack workspace.
+icon: "slack"
 ---
 
 Send survey responses automatically to Slack workspace.

diff --git a/docs/self-hosting/configuration/integrations/zapier.mdx b/docs/self-hosting/configuration/integrations/zapier.mdx
@@ -1,6 +1,7 @@
 ---
 title: Zapier (On Premise)
 description: Set up automations with your self-hosted Zapier instance.
+icon: "bolt"
 ---
 
 The Zapier integration allows you to create automations based on survey responses.
@@ -27,7 +28,7 @@ Connect Formbricks with Zapier: You have to connect Zapier with Formbricks via a
 
 ![second](https://res.cloudinary.com/dwdb9tvii/image/upload/v1738254061/image_apgw1y.jpg)
 
-Now you need an API key. Please refer to the [API Key Setup](/api-reference/rest-api#how-to-generate-an-api-key) page to learn how to create one.
+Now you need an API key. Please refer to the [API Key Setup](/api-reference/generate-key) page to learn how to create one.
 
 Once you copied it in the newly opened Zapier window, you will be connected:
 

diff --git a/docs/surveys/best-practices/cancel-subscription.mdx b/docs/surveys/best-practices/cancel-subscription.mdx
@@ -1,103 +1,51 @@
 ---
-title: "Learn from Churn"
-description: "Mastering Churn Surveys with Formbricks | Essential Tips & Steps"
-icon: "chart-line-down"
+title: "Churn Survey"
+description: "Learn why customers cancel their subscription, at the moment they cancel."
+icon: "user-minus"
 ---
 
-Churn is hard, but can teach you a lot. Whenever a user decides that your product isn’t worth it anymore, you have a unique opportunity to get deep insights. These insights are pure gold to reduce churn.
+A churn survey asks why someone is leaving, at the one moment they are certain of the answer.
 
 ## Purpose
 
-The Churn Survey is among the most effective ways to identify weaknesses in your offering. People were willing to pay but now are not anymore: What changed? Let’s find out!
+Asked a week later by email, the answer is a rationalisation. Asked at the click of the cancel button, it is the reason.
 
-## Formbricks Approach
+## 1. Start from the template
 
-* Ask at exactly the right point in time
+Open **Surveys**, click **New Survey** and choose **Choose a template**. Search for **Churn Survey**, then click the card to create the survey.
 
-* Follow-up to prevent bad reviews
+![The Churn Survey template in the template picker](/images/surveys/best-practices/cancel-subscription/template.webp)
 
-## Overview
+The template asks for a reason and then for detail. Keep it to that: someone mid-cancellation will not fill in a long form.
 
-To run the Churn Survey in your app you want to proceed as follows:
+## 2. Trigger it at the right moment
 
-1. Create new Churn Survey at [app.formbricks.com](https://app.formbricks.com/)
+The trigger is your cancel button. Open the **Settings** tab, find **Survey Trigger** and add an action that matches it — **Inner Text** `Cancel Subscription` is usually enough, and a **CSS Selector** such as `#cancel-subscription` is better if more than one button carries that label.
 
-2. Set up the user action to display survey at right point in time
+![The Survey Trigger section with the action attached](/images/surveys/best-practices/cancel-subscription/trigger.webp)
 
-3. Choose correct recontact options to never miss a feedback
+<Tip>
+  Creating the action itself — Click versus Page View, Inner Text versus CSS Selector — is the same dialog
+  in every recipe. It is walked through once on the [Feedback Box](/surveys/best-practices/feedback-box)
+  page, and the full reference is the [Actions manual](/surveys/website-app-surveys/actions).
+</Tip>
 
-4. Prevent that churn!
+## 3. Decide how often it may appear
 
-<Note>
-  ### Formbricks Widget running? We assume that you have already installed the
+Still on **Settings**, open **Visibility & Recontact**. Choose **Show only once**. A cancellation is a one-time event, and someone who has already answered should not be asked twice.
 
-  Formbricks Widget in your web app. It’s required to display messages and
-  surveys in your app. If not, please follow the [Quick Start Guide (takes
-  15mins max.)](/surveys/website-app-surveys/quickstart)
+<Note>
+  Recontact Options and the workspace-wide [Cooldown Period](/surveys/website-app-surveys/cooldown-period)
+  are two separate gates and a survey has to pass both — Recontact Options first, then the cooldown. If
+  your workspace shows at most one survey a week, this survey inherits that unless you set **Ignore
+  Cooldown Period**.
 </Note>
 
-### 1. Create new Churn Survey
-
-If you don't have an account yet, create one at [app.formbricks.com](https://app.formbricks.com/auth/signup)
-
-Click on "Create Survey" and choose the template [Churn Survey](https://formbricks.com/survey-templates/churn-survey):
-
-![Create churn survey by template](/images/surveys/best-practices/cancel-subscription/create-cancel-flow.webp)
-
-### 2. Update questions (if you like)
-
-You’re free to update the question and answer options. However, based on our experience, we suggest giving the provided template a go 😊
-
-![Change text content](/images/surveys/best-practices/cancel-subscription/change-text.webp)
-
-*Want to change the button color? You can do so in **Settings → Workspace → Appearance**.*
-
-Save, and move over to the “Audience” tab.
-
-### 3. Pre-segment your audience
-
-In this case, you don’t really need to pre-segment your audience. You likely want to ask everyone who hits the “Cancel subscription” button.
-
-### 4. Set up a trigger
-
-To create the trigger for your Churn Survey, you have three options to choose from:
-
-* **Trigger by Inner Text:** You likely have a “Cancel Subscription” button in your app. You can setup a user Action with the according `Inner Text` to trigger the survey, like so:
+## 4. Publish
 
-![Set the trigger by inner Text](/images/surveys/best-practices/cancel-subscription/trigger-inner-text.webp)
-
-* **Trigger by CSS Selector:** In case you have more than one button saying “Cancel Subscription” in your app and only want to display the survey when one of them is clicked, you want to be more specific. The best way to do that is to give this button the HTML `id=“cancel-subscription”` and set your user action up like so:
-
-![Set the trigger by CSS Selector](/images/surveys/best-practices/cancel-subscription/trigger-css-selector.webp)
-
-* **Trigger by page view filters:** Lastly, you could also display your survey on a subpage “/subscription-cancelled” where you forward users once they cancelled the trial subscription. You can then create a user Action with the type `Page View` and add select `Limit to specific pages` to add url filters, with the following settings:
-
-![Set the trigger by page URL](/images/surveys/best-practices/cancel-subscription/trigger-page-url.webp)
-
-Whenever a user visits this page, matches the filter conditions above and the recontact options (below) the survey will be displayed ✅
-
-Here is our complete [Actions manual](/surveys/website-app-surveys/actions) covering [No-Code](/surveys/website-app-surveys/actions#setting-up-no-code-actions) and [Code](/surveys/website-app-surveys/actions#setting-up-code-actions) Actions.
-
-### 5. Select Action in the “When to ask” card
-
-![Select feedback button action](/images/surveys/best-practices/cancel-subscription/select-action.webp)
-
-### 6. Last step: Set Recontact Options correctly
-
-Lastly, scroll down to “Recontact Options”. Here you have to choose the correct settings to make sure you milk these super valuable insights. You want to make sure that this survey is always displayed, no matter if the user has already seen a survey in the past days:
-
-![Set recontact options](/images/surveys/best-practices/cancel-subscription/recontact-options.webp)
-
-These settings make sure the survey is always displayed, when a user wants to Cancel their subscription.
-
-### 7. Congrats! You’re ready to publish your survey 💃
-
-![Publish survey](/images/surveys/best-practices/cancel-subscription/publish-survey.webp)
+**Publish** puts it live. The widget picks up the change within a minute.
 
 <Note>
-  Formbricks Widget running? You need to have the Formbricks Widget installed
-  to display the Churn Survey in your app. Please follow [this tutorial (Step 4
-  onwards)](/surveys/website-app-surveys/quickstart) to install the widget.
+  This is an app survey, so it needs the Formbricks widget running in your product. If you have not
+  installed it yet, follow [the quickstart](/surveys/website-app-surveys/quickstart) first.
 </Note>
-
-### **Get those insights! 🎉**