> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-forms/design/share-card.md). # Share card (social preview image) Control the preview image that appears when your Dapta Form link is shared in chat or on social media: a 1200×630 card generated automatically from your design, or your own image URL. A form is shared as a link far more often than it is found by search. When someone pastes your public link into WhatsApp, Slack, LinkedIn, X or an email client, those apps show a preview card: a title, a short description and an image. Dapta Forms builds that image for you, at the standard 1200×630 size, straight from the colors, typeface, logo and cover copy of your form. Change a color in **Design** and the card changes with it. Nothing to upload. If you already have a designed asset, paste its URL and it is used instead. *** **Step 1:** Open your form, click **Design** in the toolbar and scroll to the **Share card** section. The small mock-up at the top shows how the link reads (your account code and the title), so you can check the wording at a glance. **Step 2:** To use your own image, paste a public link into **Share image URL**. Ideal size is 1200×630 pixels. Leave the field empty to keep the generated card.

The Share card section. Paste an image URL to override the generated card, or leave it empty.

**Step 3:** Click **Publish**. To see the generated image, open your public link and add `/opengraph-image` to the end, for example `https://forms.dapta.ai/k7m2xq/alex/product-fit-quiz/opengraph-image`.

The generated 1200 by 630 share card: dark background from the form theme, Dapta Forms mark, the banner text as a pill, the cover headline and subheadline, a progress bar, the question count, the host name and a Start button in the accent color — The generated card for a form with a dark theme, a banner and a cover. The Start button takes the form's accent color.

## What the generated card shows The card is laid out from your form's own design, so it looks like the page it opens. | Part of the card | Where it comes from | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Background and colors | The **Theme**, **Colors** and **Background style** of the form (including a background image, dimmed so the text stays readable). | | Typeface, corners and button style | **Typography** and **Shape and controls** in the Design panel. | | Logo | **Form logo URL** (or **Cover logo URL**) from the **Layout** section. With no logo, the card shows the Dapta Forms mark. | | Pill above the headline | The **Banner text** of the cover, if any. | | Headline | The cover **Headline**. If empty, the public **Form title**; if that is empty too, the form's internal name. | | Second line | The cover **Subheadline**. If empty, the text of the first question. | | Footer | The number of questions, the host name (for example forms.dapta.ai) and a **Start** button in the accent color. The button always reads **Start**, regardless of your custom Start button text. | The title and description of the link preview (the text next to the image) come from the same places: the public **Form title** (falling back to the form name), and the cover **Subheadline** (falling back to "Fill out {form name} online."). ## Good to know * **Updates take a few minutes.** The generated card is refreshed about every 10 minutes, so a change in **Design** may take that long to show up in a new share. Social platforms keep their own copy for longer; most of them offer a "re-scrape" or "refresh preview" tool if you need the new card immediately. * **Your own image wins completely.** When **Share image URL** is set, the generated card is not used at all. Use a public HTTPS link to a PNG or JPG; the platforms ignore images they cannot download. * **Publish first.** The card is built from the published version of the form, so design changes you have not published yet do not appear on it. ## What's next * [Cover screen & banner](/dapta-forms/design/cover-screen-and-banner.md) * [Logos, layout & transitions](/dapta-forms/design/logos-layout-transitions.md) * [Themes, colors & background](/dapta-forms/design/themes-colors-background.md) * [Your public link](/dapta-forms/share/public-link.md) --- # 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.dapta.ai/dapta-forms/design/share-card.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.