One Click survey links let you share a Grapevine Survey wherever a clickable link can appear, without relying on on‑site triggers or checkout events.
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.
What are One Click survey links?
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.
Because of this behaviour, only certain surveys are eligible to be used as One Click surveys. To qualify as for One Click functionality, a survey must:
Contain exactly one question
Use a set of predefined fixed responses
Each possible answer in the survey will be assigned its own unique URL‑encoded value.
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:
Attribute responses to a known customer
Associate feedback with a specific order
Pre‑fill metadata for reporting, filtering, and exports
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.
Where can I use One Click survey links?
You can use One Click Survey Links anywhere links are supported, including:
Email campaigns (e.g. Mailchimp, Klaviyo, Shopify Email)
Shopify order notification emails
Order follow‑up or review request emails
SMS messages
Live chat or support conversations
Helpdesk replies or support macros
Social or private community messages
If a customer can click the link, they can complete the survey.
Enabling One Click Survey Links
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.
How to enable One Click
To enable One Click survey links:
Open the survey in the Grapevine Surveys editor
Look for the One Click option within the Manage visibility pane (right-hand side)
Enable the One click option
Once enabled, One Click survey links will be generated for each fixed response answer.
Tip: One Click can be enabled alongside other visibility options (such as Standalone/On-site survey pages), depending on how you plan to distribute the survey.
How One Click response links are generated
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.
Response-to-URL encoding
Each fixed response is:
URL encoded to ensure it is safe to use in a link (for example, spaces become
%20)Added to the One Click Survey endpoint as an
answerquery parameter
The One Click survey URL itself also contains two important identifiers:
Survey code - uniquely identifies the survey
Question code - uniquely identifies the question within that survey
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:
In this example:
{survey_code}identifies the unique survey code{question_code}identifies the unique question codeanswer=A%20Google%20searchrepresents the selected response
One link per answer
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:
Is pre-configured with the correct encoded answer value
Can be copied individually
Can be placed directly into emails, messages, buttons, or automations
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.
URL variables (optional, but powerful)
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:
Filtering and segmentation of responses
Exporting enriched response data
Matching responses back to Shopify orders or customers
Supported Variables
Variable | Description | Example |
| Customer first name |
|
| Customer last name |
|
| Customer email address | |
| Shopify order ID |
|
| Shopify customer ID |
|
| External identifier (stored in metadata) |
|
Tip: Variables are optional. If you don’t include them, the survey will still work but it will simply be collected as an anonymous response.
Example: Basic One Click survey link
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.
Example: Linking a response to a customer and order
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:
The response will be associated with that email address
The order ID and customer ID will be stored on the response
You can filter or export results using these values
Using Dynamic Values from Email & Marketing Tools
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.
Example: Shopify Email / Klaviyo‑style placeholders
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:'' }}
Example: Mailchimp merge tags
https://myexamplestore.com/tools/survey/one-click/947263555e9f32/99283ce991eef?answer=This%20is%20my%20selection&first_name=*|FNAME|*&email=*|EMAIL|*
Example: Using external_id
The external_id field is useful when:
You want to store an internal reference (ticket ID, case number, campaign ID)
You’re matching survey data with another system outside Shopify
https://myexamplestore.com/tools/survey/one-click/947263555e9f32/99283ce991eef?answer=This%20is%20my%20selection&external_id={{ support_ticket_id }}
Response behaviour after click
When configuring a One Click survey, you can choose one of the following response behaviours:
Show a Thank You Page
After the click response is recorded, the customer is shown a simple confirmation page which is a proxy page created by Grapevine-Surveys to display a page on your site.
This option is ideal when:
The link is shared with customers (email, SMS, live chat)
You want to clearly acknowledge that their feedback was received
No further automation is required after the click
Thank You page configuration
When using the Thank You page response type, you can customise the following fields:
Thank you page title -
Thank you!Thank you page text:
Your response has been recorded. We appreciate your feedback.Button text:
ContinueButton link (optional):
https://example.com- Leave this empty to hide the button entirely.
This allows you to keep the experience simple, or optionally send customers back to your store, help centre, or another relevant destination.
Return a JSON Payload
Instead of showing a page, Grapevine can return a custom JSON response when the link is clicked.
This option is designed for:
Programmatic usage
Webhooks or automation tools
Backend or server-side integrations
Tracking responses inside external systems
You can define the exact JSON structure that will be returned.
Example JSON Response
{
"status": "success",
"message": "Response recorded"
}Important: The JSON payload must be valid JSON.
When this response type is selected, the endpoint behaves like an API-style response rather than a customer-facing page.
Common Use Cases
Post‑purchase follow‑ups
Send a targeted survey a few days after delivery, tied back to the original order.
Support & live chat feedback
Drop a survey link at the end of a support conversation and associate it with a ticket or customer.
SMS micro‑surveys
Ask a single, high‑intent question via SMS and capture structured responses.
Campaign‑specific insight
Include a campaign or experiment identifier via external_id to compare responses across initiatives.
Things to Keep in Mind
URL values should be URL‑encoded if they may contain spaces or special characters
Anyone with the link can access the survey, so we'd advise you not to include any sensitive data
One Click survey links work independently of on‑site or post‑purchase survey triggers
Summary
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.