> For the complete documentation index, see [llms.txt](https://docs.zigpoll.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zigpoll.com/public-link.md).
# Public Link
Learn about how to best utilize your Survey's public link.
Every survey comes with a public link for easy sharing. Find it in the **Public Link** card on the survey's **Settings → General** page. It looks like `https://survey.zigpoll.com/SURVEY_ID`. Accounts with a [custom survey domain](/custom-survey-domains.md) see their own domain instead.
***
## 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.
{% hint style="info" %}
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.
{% endhint %}
***
## 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** under the link on the General tab 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](/polls/language-settings.md). |
| `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. |
{% hint style="warning" %}
When your account reaches its monthly response limit, surveys stop showing everywhere, including public links. They start working again when the limit resets on the 1st of the month or when you upgrade.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.zigpoll.com/public-link.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
