For the complete documentation index, see llms.txt. This page is also available as Markdown.

Public Link

Learn about how to best utilize your Survey's public link.

Every survey comes with a public link for easy sharing. Once the survey is live, click the link icon in the survey's header (next to the Live switch) to open it in a new tab. Surveys delivered as a link also show it in the Public Link card under Settings → Delivery → Format, with the Link format selected. It looks like https://survey.zigpoll.com/SURVEY_ID. Accounts with a custom survey domain see their own domain instead.

The public link icon in the survey header

Social Media Metadata

When you share your survey link on social media, messaging apps (iMessage, WhatsApp, Slack), or anywhere that generates a link preview, Zigpoll automatically includes Open Graph metadata so your survey looks great.

By default, shared links will display the Zigpoll branding. You can customize this in the Metadata section under the survey's Settings → Design → Survey Page.

Social Media Image

Upload a custom image that will appear in link previews when your survey is shared. This image is used as the og:image for platforms like Facebook, Twitter/X, LinkedIn, iMessage, and Slack.

For best results, use an image that is at least 1200x630 pixels.

Page Title

Set a custom title for your survey's share page. This will appear as the link preview title instead of the default "Zigpoll : Survey Name" format.

Favicon

Upload a custom favicon to replace the default Zigpoll icon in the browser tab when respondents visit your survey link. The uploaded image is automatically cropped to a square and resized to 180x180 pixels, which covers standard favicons and Apple Touch Icons.

These settings can be configured at the account level (applied to all surveys) or overridden at the survey level. Navigate to Settings → Design Defaults → Survey Page for account-wide settings, or a survey's Settings → Design → Survey Page for survey-specific settings.


Query Parameters

All query parameters added to your survey's public link will be appended as survey metadata. You can type them onto the end of the link yourself, or click Add query variables to your public link in the Public Link card (Settings → Delivery → Format, with the Link format selected) to build the URL with a form. This means if you want to tag a specific respondent, you could do so via the following url:

https://survey.zigpoll.com/SURVEY_ID?tag=email_survey

The link above would add metadata called tag with value email_survey to any participant that responds to the survey via that url.

This is also useful if you are embedding a survey within an email template and want to track customer information. For example, to email a survey automatically when a Shopify order is fulfilled, add the following to your public link and send it in that email:

https://survey.zigpoll.com/SURVEY_ID?shopify_customer_id={{ customer.id }}&shopify_order_id={{ order.id }}

The link above will dynamically add the customer id, and the order id to each participant. This allows you to keep track of who filled out your survey and gives you the opportunity to respond to them if necessary.

Parameters with special meaning

Parameter
What it does

lang

Opens the survey in that language, for example ?lang=fr or ?lang=fr-CA. It overrides the visitor's browser language. The survey must have that language set up under Settings → Language. See Language Settings.

email

Attaches the respondent's email address to their response.

shopify_customer_id / shopify_order_id

Link the response to a Shopify customer or order.

a

Pre-selects an answer to the first question, by its handle or title. Zigpoll's own survey emails use this when a customer clicks an answer inside the email.

Last updated