One Click survey links let you share a Grapevine Survey wherever a clickable link can appear, without the need for on‑site triggers or checkout events to present a survey.

This makes it easy to collect feedback via email, SMS, live chat, support conversations, or any other outbound channel, while also allowing you to associate responses back to a specific customer or order.

One Click survey links are response-specific URLs that allow customers to submit a survey answer with a single click, without opening or viewing a survey page.

Only certain surveys are eligible to be used as One Click surveys.

To qualify for One Click functionality, the first question of a survey must use a set of predefined fixed responses, e.g.

Each possible answer in the survey will then be assigned its own unique URL‑encoded value.

If your survey contains further questions, respondents can be taken to the One Click proxy page on your store to answer those additional questions.

When a customer clicks one of these links, the response will be recorded against the Grapevine Survey question immediately.

One Click survey links can optionally include URL variables that pass customer or order data into the survey, allowing Grapevine to:

You can control what happens after a customer clicks a One Click survey link. You can either choose to direct the respondent to a Thank You page that we create dynamically on your site, or, to return a JSON response.

These two response types provide confirmation that the survey answer has been submitted, one as a human-facing confirmation and the other as a system-based confirmation.

You can use One Click Survey Links anywhere links are supported, including:

If a customer can click the link, they can complete the survey.

The One Click option only appears if the survey meets the eligibility requirements and must be explicitly enabled for each eligible survey.

If a survey does not meet these criteria, the One Click option will be disabled.

To enable One Click survey links:

Once enabled and your survey has been saved, One Click survey links will be generated for each fixed response answer.

To access your One Click survey links, exit the survey editor and you will be taken back to the Survey Report View. At the top of that page you will see a toggle between the Report view and the Set-up instructions view.

Click on the Set-up instructions option:

Within the Set-up Instructions view, you will see instructions for each channel that you have enabled your survey for.

Find the One Click Survey section and click on View links & settings:

You will then be presented with a page full of your One Click survey links and settings:

Grapevine generates the One Click survey links for each response option, but it does not generate the email or the HTML, CSS or images used to present those links.

This means that:

You can choose to present your links as:

How these appear depends on the capabilities of your email or messaging platform.

This approach gives you full flexibility to match your brand, design, and customer experience while still allowing Grapevine Surveys to record responses instantly when a link is clicked.

When a survey is eligible to be used as a One Click survey (single question with fixed answers), and the One Click visibility channel is enabled, we will automatically generate a separate, response-specific link for each answer option.

Each fixed response is:

The One Click survey URL itself also contains two important identifiers:

These appear as two identifier segments of the URL, directly after the one-click segment in the URL.

Together, these identifiers allow Grapevine Surveys to know which survey, which question, and which answer the click relates to.

For example:

https://your-store.myshopify.com/tools/survey/one-click/{survey_code}/{question_code}?answer=A%20Google%20search

In this example:

When viewing your survey in the Grapevine Surveys app, you'll see a One Click button at the top of the page. Clicking on that option will bring you to the One Click information page that contains a list of all of your One Click survey links for that survey, one link for each possible response.

Each link:

This makes it easy to present multiple response options side-by-side.

For example, in an email or support reply where you're asking a customer if they are satisfied with their experience (CSAT survey), a set of smiley face icons (ranging from happy to unhappy) can be used to convey the level of satisfaction the customer is feeling. Each icon can be configured as a clickable element to use the One Click link that corresponds with that satisfaction level as it's href value.

You can append variables to a One Click survey link to pass customer or order information along with the survey response.

These values are stored as metadata on the survey response and can be used for:

https://myexamplestore.com/tools/survey/one-click/947263555e9f32/99283ce991eef?answer=This%20is%20my%20selection

This link responds to the survey with no associated customer or order data.

https://myexamplestore.com/tools/survey/one-click/947263555e9f32/99283ce991eef?answer=This%20is%20my%20selection&[email protected]&order_id=1234567890&customer_id=987654321

When the customer completes the survey:

In most cases, you won’t hard‑code values into the URL. Instead, you’ll use merge fields, placeholders, or metafields provided by your platform.

https://myexamplestore.com/tools/survey/one-click/947263555e9f32/99283ce991eef?answer=This%20is%20my%20selection&first_name={{ first_name|default:'' }}&email={{ email|default:'' }}&order_id={{ event.extra.id|default:'' }}

https://myexamplestore.com/tools/survey/one-click/947263555e9f32/99283ce991eef?answer=This%20is%20my%20selection&first_name=*|FNAME|*&email=*|EMAIL|*

The external_id field is useful when:

https://myexamplestore.com/tools/survey/one-click/947263555e9f32/99283ce991eef?answer=This%20is%20my%20selection&external_id={{ support_ticket_id }}

When configuring a One Click survey, you can choose one of the following response behaviours:

After the click response is recorded, if the survey has additional questions, then the respondent is taken to a proxy page on your site where they can answer further questions from your survey.

The proxy-page is created by Grapevine-Surveys and will inherit your theme's header, footer and styling.

After the click response is recorded, if the survey only has a single question, the respondent is shown a simple confirmation page. The confirmation page is a proxy-page on your site, created by Grapevine-Surveys that will inherit your theme's header, footer and styling.

This option is ideal when:

When using the Thank You page response type, you can customise the following fields:

This allows you to keep the experience simple, or optionally send customers back to your store, help centre, or another relevant destination.

Instead of showing a page, Grapevine can return a custom JSON response when the link is clicked.

This option is designed for:

You can define the exact JSON structure that will be returned.

Example JSON Response

When this response type is selected, the endpoint behaves like an API-style response rather than a customer-facing page.

Use the Custom CSS field within the One Click settings to apply additional styling to the One Click landing page on your storefront.

This setting is useful when you want to match the survey experience to your storefront branding or adjust the appearance of key messages shown during the One Click survey flow. CSS styles entered here will apply to the following states of the One Click survey journey:

This is the confirmation message shown after a customer successfully submits their survey response and there are no further questions to answer.

This is the message displayed when a customer tries to submit another response to the same survey.

When there are further questions to be completed, the question and answer options can be styled by adding Custom CSS here. The Next and Submit buttons can also be styled.

For an overview of the styles that can be targeted on the One Click landing page, please see our article styling the One Click landing page with Custom CSS

If you are using Shopify Markets and have configured one survey per market or language, you must update your One Click survey URLs to include the correct market domain identifier.

This ensures that when a customer clicks their survey link, the Thank You page loads on the correct market domain. If the domain is not adapted, customers will be taken to your default domain where the header and footer may be in in the wrong language.

For each survey tied to a specific market/language, you will need to identify the correct market domain or subfolder used by Shopify Markets and update your One Click survey links accordingly.

Example

Instead of:

https://myexamplestore.com/tools/survey/one-click/947263555e9f32/99283ce991eef?answer=This%20is%20my%20selection

Use:

Or, if using separate domains:

Each survey link should match the market it is intended for.

Send a targeted survey a few days after delivery, tied back to the original order.

Drop a survey link at the end of a support conversation and associate it with a ticket or customer.

Ask a single, high‑intent question via SMS and capture structured responses.

Include a campaign or experiment identifier via external_id to compare responses across initiatives.

When building a One Click survey, especially one that includes follow-up questions or redirects to another page, it's important to be able to test the full customer experience without recording real survey responses. To ensure that no survey responses are recorded when testing your one click survey links, we recommend using the preview mode parameter.

You can safely test your One Click survey links by adding the following parameter to the end of your one click URLs:
​

https://myexamplestore.com/tools/survey/one-click/947263555e9f32/99283ce991eef?answer=This%20is%20my%20selection&preview=1

Use preview mode when you want to:

One Click Survey Links give you a flexible way to collect high‑quality feedback anywhere you communicate with customers while still keeping responses structured, attributable, and easy to analyse.

If you’re already emailing, messaging, or talking to customers, One Click Survey Links let you turn those moments into insight.

You can configure what happens after they click - either show them a thank you page or return a JSON response.

Learn more about One Click surveys in our Knowledgebase