The Link Platform
In this article:
- Link platform overview.
- How the Link platform works.
- Setting up the Link platform.
- The in-app Link Builder's 13 options.
- Adding properties in the in-app Link Builder.
- Appending properties to links—the traditional method.
FAQs
- Why are respondents getting the “We can’t find the page you’re looking for” error?
- Why are newer responses overwriting older responses?
- Where can I learn about Link survey customization?
- Can I recover respondent information from an anonymous response?
- Why are new responses not being recorded?
Link platform overview
The Link platform is the most flexible of any distribution method. Apply URLs and QR codes to a wide variety of interesting channels—email, messages, video chats, web pages, social media, print media, presentations, and more.
In this first video, learn to create custom links with our in-app Link Builder, which makes adapting, testing, and distributing your links remarkably easy.
How the Link platform works
Delighted Links are short URLs that launch surveys. For example, https://delighted.com/t/Bo5cKjF1 launches this survey with a single click. (Try it!)
Click here to take the survey!
QR codes can also be downloaded from the in-app Link Builder. With a simple scan, this image launches the same survey as the link above. (Try this too!)
The value of anonymity
Results from Link surveys are anonymous by design—which is important for studies requiring privacy. Link platform responses appear in the Dashboard with unique identifiers—such as Person (0123456789)—so the anonymous results can be rendered on Permalink pages and aggregated into summative Reports and Link Platform Metrics.
Need to collect names and email addresses?
Add the “Name” and “Email” Additional Question types to your survey so respondents can voluntarily enter their names and email addresses.
Note: You can also attach contact information to outgoing links that will identify your respondents. It’s a bit technical, but we show you how it's done at the end of this article in Appending properties to Links.
Setting up the Link Platform
To set up the Link platform for the first time:
- 1
- Click the "Survey people" button.
- 2
- Choose "Set up" in the Link platform tile.
- 3
- Walk through the basic customization steps. (For details, see Link survey customization.)
- 4
- When finished, select “Next configure.”
- 5
- As the in-app Link Builder appears, copy the link to your clipboard by clicking the “Copy” icon to the right of the URL.
- 6
- Paste the link wherever you need it! (See Testing a link.)
The in-app Link Builder's 13 options
In this part:
- Launching the Link Builder.
- The 13 Link Builder options.
- Adding a new link.
- Testing and previewing a Link platform surveys.
- Filtering link results.
- Generating, downloading and testing QR codes.
- Link survey customization.
- Editing link names.
- Deleting a link.
- Using vanity URLs to identify links.
- Preventing multiple submissions.
- Generating and using links for each scale point.
Launching the Link Builder
The Link Builder hosts more than a dozen link defining options in one convenient place. It's here where you'll add, differentiate, and customize the links you need for your survey projects.
To open the Link Builder, first locate your list of links:
- 1
- Click “Survey people.”
- 2
- Select “Adjust settings” in the Link platform tile.
- 3
-
From your list of links, choose either:
- Add a new link: To create new links for a survey.
- Settings: To make changes to any existing link in the list.
The 13 Link Builder options
Here's a quick rundown of the options packed into the in-app Link Builder.
- Back to links: Return to “Your links” list.
- "Gear" icon: Change the name of a link.
- Your unique link: This is your auto-generated link. (This URL and matching QR code never change, even as you update a project's customizations, additional questions, and properties.)
- Copy button: Click to copy your link to your clipboard.
- Enable vanity URL: Check this box to append the name of the link to the end of the URL so you can instantly tell it apart from the other links in your list. (Click "Save changes" to complete this process.)
- Prevent multiple submissions: If checked, cookies will limit responses from a single device for a 1-month period. (Uncheck to allow unlimited responses from the same device.)
- Download QR code for your link: Choose between PNG or SVG image files. (As you click your choice, the QR code will be downloaded.)
- Add properties to your link: Add a "Property name" and a "Property value" for each new property you append to this link.
- How to use links: Click to return to this Help Center article.
- Customize appearance: Click to open the customization tools for this survey.
- Individual score links: Generate a link for each scale point in your survey. (For example: 5 links for 5-star surveys, 11 for NPS surveys, and 2 for Thumbs.)
- Delete this link: Delete the current custom link. (This does not delete the data already collected with this link.)
- Save changes: Apply all of the changes you have made to this link.
Adding a new link
Use the Link Builder to create and filter results from as many custom links as you need for your survey. You can define links that will segment responses from different:
- Locations
- Interactions with specific team members
- Points-of-purchase (ex. online, mobile app, or retail)
- A/B marketing comparisons
- Product lines (ex. Women’s vs. Men's collections)
Think of a company, like Hem & Stitch, that wants to send the same survey to its customers while also segmenting the performance from several independent locations. In this survey, we’ve already added links for “Chicago” and “Dublin." Now let’s add a link for a “Guadalajara” location.
To add a new link:
- 1
- Click “Survey people.”
- 2
- Choose “Adjust settings” from the Link platform tile.
- 3
- Click “Add a new link” seen below the list of existing links.
- 4
- In the Link Builder, name your new link (ex. “Guadalajara”).
- 5
- Click “Save and finish.”
- 6
- Select “Back to links” to return to the your list of links.
- 7
- Add more links by repeating steps 3-5.
Testing and previewing Link platform surveys
To test and preview any link in your survey's list:
- 1
- Reopen the Platforms page by clicking the “Survey people” button and choosing “Adjust settings” from the Link platform tile.
- 2
- Click the “Copy” icon next to a link on your list and save it to your clipboard. (You can also snag the link from the Link Builder.)
- 3
- Paste the link into your browser and press “Enter.”
- 4
- Preview and take your survey!
If you test a link more than once, your initial survey response will be overwritten by your new response. There's a Delighted cookie at play. By default, a cookie limits respondents to one survey per month, including you!
Note: Here's three ways to avoid this issue:
A. Change the submissions default in the Link Builder. (See Preventing multiple submissions.)
B. Use an incognito browser to test links.
C. Clear your browser history before you retest a link.
Filtering link results
To filter the results by location properties, return to your Dashboard and:
- 1
- Click “Add a new filter.”
- 2
- Select “Delighted Link Name” from the list of properties.
- 3
- Filter your results (ex. “Chicago,” “Dublin,” and “Guadalajara”)!
Generating, downloading and testing QR codes
QR codes make sharing a survey on posters, presentations, mailers, receipts, and other visual media super easy!
To download a QR code:
- 1
- Click “Survey people.”
- 2
- Choose "Adjust settings" in the Link platform tile.
- 3
- From your list of links, click “Settings” adjacent to the specific URL for which you seek a QR code.
- 4
- Download the QR code by choosing an image file type ("PNG” or “SVG”) from the “Download a QR code for your link” section of the Link Builder.
- 5
- Open the image file and apply the QR code as needed.
- 6
- Scan the image to test your QR code.
Certainly! To adjust the size of the QR code, set the Property name Delighted_qr_png_size to the desired number of pixels for the QR code image (which will always be formatted in a square).
Link survey customization
Need to edit the customization settings of your Link survey? Not a problem! There are two ways to access customization. The first option is to:
- 1
- Click “Customize appearance” from the right-hand side of the Link Builder.
-
The second option is to:
- 1
- Click “Survey people.”
- 2
- Click on the “Gear” icon from the Links platform tile.
- 3
- Choose "Customize appearance" from the menu.
-
Where can I learn about Link survey customization?
Read our Link Platform Customization—Deep Dive article in Section 4 of the Help Center and learn all of the details.
Editing link names
To change or edit the name of a link named "Ireland" to "Dublin" in the Link Builder:
- 1
- Click “Survey people.”
- 2
- Choose “Adjust settings” in the Link platform tile.
- 3
- Click “Settings” next to the link you wish to rename.
- 4
- In the Link Builder, click the “Gear” icon next to the current name (Ireland).
- 5
- Enter your new name into the “Edit link” window (Dublin).
- 6
- Click “Save changes.”
Deleting a link
Good news! Deleting a link does NOT delete any of the responses that you have already collected with the link, so you'll still be able to analyze the results.
To delete any of your links:
- 1
- Click “Survey people.”
- 2
- Choose “Adjust settings” in the Link platform tile.
- 3
- Select the “Settings” link from “Your Links” list.
- 4
- Click “Delete link” in the bottom right-hand panel of the Link Builder.
- 5
- Click “OK” when asked, “Are you sure you want to delete this link?”
- 6
- You will have one last chance to “Undo” the deletion if you change your mind. (Look for the yellow notification bar.)
If your respondents see the error message, “We can’t find the page you’re looking for,” chances are the link has been deleted. Remember to remove deleted links from social media, email signatures, or wherever else they may live!
Using vanity URLs to identify links
The “Enable vanity URL” feature will attach the link’s name to the end of the URL string. Flagging URLs in this way simplifies link management by making your links easier to spot!
To enable vanity URL identification:
- 1
- Click “Survey people.”
- 2
- Choose “Adjust settings” in the Link platform tile.
- 3
- Click “Settings” next to the link you wish to flag.
- 4
- In the in-app Link Builder, click “Enable vanity URL.”
- 5
- Click “Save changes.”
Preventing multiple submissions
As you create a link with the Link Builder, you’ll see the “Prevent multiple submissions” box checked by default:
- If “Prevent multiple submissions” is checked: The customer can only respond to the survey once per month. If they submit another response, it will overwrite their prior answers.
- If “Prevent multiple submissions” is unchecked: All responses will be received and recorded separately.
Keeping “Prevent multiple submissions” checked will help you avoid being spammed as you go live. Nevertheless, temporarily unchecking this feature is useful for testing, as you can test a link as often as you like without triggering a cookie or having to use an incognito browser.
Important: If your study requires you to survey people more than once per month, definitely remove the checkmark in the "Prevent multiple submissions" box and enable multiple responses from the same people each month.
Generating and using links for each scale point
The in-app Link Builder will "Get individual links for each score," or scale point, in your question. One way to use individual score links is in email signatures. (For a detailed walkthrough of how to set this up, visit our Email Signature Surveys article.)
To generate individual links for each scale point:
- 1
- Click “Survey people” and choose “Adjust settings” in the Link platform tile.
- 2
- Click “Settings” next to the link you wish to use for your individual links.
- 3
- On the right-hand side of the Link Builder, click "Get individual links for each score."
- 4
- Click the “Copy” button next to each link.
- 5
- Paste the individual score links, one by one, wherever you need them.
- Introducing our adding properties video.
- Defining properties with names and values step by step.
- Filtering by extra properties.
- Removing and editing extra properties.
- 1
- Click “Survey people” and choose “Adjust settings” from the Link platform tile.
- 2
- Click “Add a new link” under your list of active links.
- 3
- Name the new link (ex. “Ellie”).
- 4
- Click “Add a property.”
- 5
- Enter “Agent” followed by a value ex. “003.”
- 6
- Click “Add a property” again and enter “Manager” followed by the value “Sean.”
- 7
- Click “Add a property” one more time and enter “Title” followed by the value “Assistant product manager.”
- 8
- Click “Save and finish.”
- 1
- Click “Add a new filter.”
- 2
- Select your new properties from the list. (Notice the purple "New" tags.)
- 3
- Filter your results (ex. “Agent,” “Manager,” and “Title.”)
- 1
- Click “Settings” next to the link in your list that you want to delete or edit.
- 2
- In the Link Builder, click “Remove” to the right of the property and value.
- 3
- Optional: To replace the deleted property click “Add a property.”
- 4
- Enter a new “Property name” and “Property value."
- 5
- Click “Save changes.”
- The first parameter should start with `?`, while all subsequent parameters should start with `&`. For example: https://delighted.com/t/Bo5cKjF1?name=Sean&email=hello%40delighted.com
- All special characters should be encoded (ex. %40 is how to encode the @ symbol). You might consider using a URL encoder/decoder to help grab the correct encoding
- Name: "name=sean"
- Email: "email=sean%40delighted.com" (%40 is how to encode the @ symbol).
- Properties: "propertyname=value" (ex. "Purchase Location" set to "Retail": "purchase_location=retail")
- Replace the deleted link with a new one.
- Remove the reference to the deleted link.

Adding properties in the in-app Link Builder
In this part:
Introducing our adding properties video
In this part, we'll explore how you can add multiple layers of properties to each of your links with the Link Builder. Properties can add clarity, specificity, and context to your research.
Watch this video to see how it’s done!
Need a refresher on properties before diving in?
Visit section 5. Managing People and Properties.
Defining property names and values step by step
Let’s add a new link for agent “Ellie” and layer in the following properties and values:
Property name | Property value |
Agent | Value (number) |
Manager | Value (text) |
Title | Value (text) |
To learn how to create a new link and append additional properties and values, review this example:
Filtering by extra properties
To filter incoming results by any of the extra properties you’ve added, return to your Dashboard and:
Note: Read all about the different ways to filter your Dashboard here.
Removing and editing extra properties
To edit property names or values, you must first remove and then recreate the property:
Appending properties to Links—the traditional method
If the non-technical Link Builder can’t get the job done, you can deploy the traditional method of appending properties to survey links as described in this section.
A common use case for this conventional approach may be to assist in sending email marketing surveys through third-party vendors, adding surveys to Salesforce campaigns, or dynamically sending surveys through certain integrations. (See section 8. Integrating with Other Applications in this Help Center.)
We recommend watching this overview video. It’s under 5 minutes and is well worth the time.
A. Proper encoding of the URL string.
B. Correct structure for the name, email, and property parameters.
A. Proper encoding of the URL string
Keep these important encoding tips in mind when appending attributes to links:
B. Correct structure for the name, email, and property parameters
Capitalization matters for both name and email parameters which should be lowercase. For properties, you can decide on your own capitalization!
An applied example
With the above in mind, here is an example with the name set to Sean, email set to sean@delighted.com, and "purchase_location" set to "retail":
https://delighted.com/t/Bo5cKjF1?name=Sean&email=sean%40delighted.com&purchase_location=retail
A note about dynamic variables
Many third-party platforms include placeholders or "liquid variables" to pass over information such as recipient email and name parameters. Reach out to your platform's support team to confirm what’s available!
Why are respondents getting the “We can’t find the page you’re looking for” error
If the link your survey takers are clicking was deleted in the Link Builder, they'll receive an error message saying, “We can’t find the page you’re looking for.” There are two options:
Why are newer responses overwriting older responses?
If you’re filling out the survey and older responses are being overwritten, you’re probably running into issues with cookies!
If "Prevent Multiple Submissions" is checked in the in-app Link Builder, any new responses submitted within 30 days will replace the previous answers—as if the survey had only been answered the one time.
Important: To collect all of the responses regardless of the frequency of their submission, uncheck "Prevent multiple submissions." (Read Prevent Multiple Submissions for all the details.)
Can I recover personal respondent information from an anonymous response?
No.
If a response is submitted anonymously, Delighted does not capture respondent information like names or email addresses. There is no way to identify who submitted the response.
Why are new responses not being recorded?
Double check the version of the link that you've shared with your respondents. Is it the exact same as the link shown within the Link settings page, or does it contain more letters/numbers at the end? If so, you're using what we call the "expanded" link.
Instead, you need to use the base link that we give you in the UI.
For context, the "expanded" version of the link is the URL that alters as a result of being submitted on a webpage. You can see this by pasting the survey link into a new tab on your browser and watching it transform to the "expanded" version when you hit enter.
Important: If you distribute that expanded link, every response that is collected is overwritten by the next one and they will not appear in the Dashboard.
You will need to distribute the correct link if you want to load all of your responses in the Dashboard!