diff --git a/apps/web/app/(app)/environments/[environmentId]/surveys/[surveyId]/(analysis)/summary/components/shareEmbedModal/anonymous-links-tab.tsx b/apps/web/app/(app)/environments/[environmentId]/surveys/[surveyId]/(analysis)/summary/components/shareEmbedModal/anonymous-links-tab.tsx
index 59af140cb6f1..9f2bfb80ac7e 100644
--- a/apps/web/app/(app)/environments/[environmentId]/surveys/[surveyId]/(analysis)/summary/components/shareEmbedModal/anonymous-links-tab.tsx
+++ b/apps/web/app/(app)/environments/[environmentId]/surveys/[surveyId]/(analysis)/summary/components/shareEmbedModal/anonymous-links-tab.tsx
@@ -352,7 +352,7 @@ export const AnonymousLinksTab = ({
},
{
title: t("environments.surveys.share.anonymous_links.custom_start_point"),
- href: "https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/start-at-question",
+ href: "https://formbricks.com/docs/xm-and-surveys/surveys/link-surveys/start-at-block",
},
]}
/>
diff --git a/docs/docs.json b/docs/docs.json
index eac96985ff08..5020320841b0 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -99,7 +99,7 @@
"xm-and-surveys/surveys/link-surveys/personal-links",
"xm-and-surveys/surveys/link-surveys/single-use-links",
"xm-and-surveys/surveys/link-surveys/source-tracking",
- "xm-and-surveys/surveys/link-surveys/start-at-question",
+ "xm-and-surveys/surveys/link-surveys/start-at-block",
"xm-and-surveys/surveys/link-surveys/verify-email-before-survey",
"xm-and-surveys/surveys/link-surveys/market-research-panel",
"xm-and-surveys/surveys/link-surveys/pin-protected-surveys",
@@ -516,9 +516,13 @@
"source": "/docs/link-surveys/global/schedule-start-end-dates"
},
{
- "destination": "/docs/xm-and-surveys/surveys/link-surveys/start-at-question",
+ "destination": "/docs/xm-and-surveys/surveys/link-surveys/start-at-block",
"source": "/docs/link-surveys/start-at-question"
},
+ {
+ "destination": "/docs/xm-and-surveys/surveys/link-surveys/start-at-block",
+ "source": "/docs/xm-and-surveys/surveys/link-surveys/start-at-question"
+ },
{
"destination": "/docs/xm-and-surveys/surveys/general-features/metadata",
"source": "/docs/link-surveys/global/metadata"
diff --git a/docs/xm-and-surveys/surveys/link-surveys/start-at-block.mdx b/docs/xm-and-surveys/surveys/link-surveys/start-at-block.mdx
new file mode 100644
index 000000000000..14c833821f44
--- /dev/null
+++ b/docs/xm-and-surveys/surveys/link-surveys/start-at-block.mdx
@@ -0,0 +1,42 @@
+---
+title: "Start At Specific Block"
+description:
+ "Start a survey at a specific block using the URL to skip earlier blocks."
+icon: "arrow-right"
+---
+
+The `startAt` URL parameter lets you open a Link Survey at a specific **block** instead of from the beginning. This is useful when you want to link to a specific part of the survey from external sources or reuse the same survey at different points in the user journey.
+
+## How it works
+
+The survey navigation is block-based: each block can contain one or more questions. When you pass `startAt` with a Question ID, the survey finds the **block** that contains that question and opens at that block. All questions in that block are shown together.
+
+
+ **Multi-question blocks:** When a block has multiple questions, `startAt` opens at the block—you will see all questions in that block, not only the question whose ID you used. For precise "start at this exact question" behavior, use one question per block.
+
+
+## How to use it
+
+1. In the Survey Editor, open the Questions Tab and ensure the survey is set as a **Link Survey**.
+
+2. Find the question (or block) you want to start at, click on **Show Advanced Settings**, and copy the **Question ID** of any question in that block.
+
+
+ Each question has a unique Question ID. Since `startAt` resolves to the block containing the question, you can use any question ID from the target block—typically the first question in that block.
+
+
+3. Append `?startAt=question_id` to your survey's URL, replacing `question_id` with the copied Question ID.
+
+4. Share this modified URL with your users to start the survey at the specified block.
+
+### Sample Link Survey URL with `startAt`
+
+```sh Example Link Survey URL with startAt configured
+https://formbricks.com/clny997dj087ho30fdzyf4nkl?startAt=bqd29m94l9k0hnc3azbrexl8
+```
+
+## Use cases
+
+- **Link to a specific block from an external source:** Direct users to a specific block in your survey from emails, chatbots, or web pages.
+- **Use the same survey in different parts of the user journey:** Reuse the survey at different stages, starting at different blocks to gather insights.
+- **Create a personalized survey experience:** Tailor the survey by starting at a particular block based on the user's past interactions or preferences.
diff --git a/docs/xm-and-surveys/surveys/link-surveys/start-at-question.mdx b/docs/xm-and-surveys/surveys/link-surveys/start-at-question.mdx
deleted file mode 100644
index 5044b9882d34..000000000000
--- a/docs/xm-and-surveys/surveys/link-surveys/start-at-question.mdx
+++ /dev/null
@@ -1,36 +0,0 @@
----
-title: "Start At Specific Question"
-description:
- "Start a survey at a specific question using the URL to skip the initial questions."
-icon: "arrow-right"
----
-
-You can start a survey at a specific question from the survey using the URL to skip the initial questions. This is useful when you want to link to a specific question from an external source or want to use the same survey in different parts of the user journey.
-
-## How to Use it?
-
-1. In the Survey Editor, open the Questions Tab and ensure the survey is set as a **Link Survey**.
-
-2. Find the question you want to start at, click on **Show Advanced Settings**, and copy the **Question ID**.
-
-
- Each question has a unique Question ID, which is used to identify it in the
- survey. You can use different Question IDs for multiple **startAt** points in
- the URL.
-
-
-3. Append `?startAt=question_id` to your survey's URL, replacing `question_id` with the copied Question ID.
-
-4. Share this modified URL with your users to start the survey at the specified question.
-
-### Sample Link Survey URL with `startAt`
-
-```sh Example Link Survey URL with startAt configured
-https://formbricks.com/clny997dj087ho30fdzyf4nkl?startAt=bqd29m94l9k0hnc3azbrexl8
-```
-
-## Use Cases
-
-- **Link to a specific question from an external source:** Use this feature to direct users to a specific question in your survey from emails, chatbots, or web pages, providing a seamless experience.
-- **Use the same survey in different parts of the user journey:** Employ the same survey at various stages of the user journey, starting at different questions to gather comprehensive insights.
-- **Create a personalized survey experience:** Tailor the survey experience by starting at a particular question based on the user's past interactions or preferences, enhancing engagement.