> 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/dforms/design/share-card.md).

# Share card (social preview image)

Control the preview image that appears when your dForms 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. dForms 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, open the **Design** tab 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.

<figure><img src="https://3835013762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCy5rSNtQmtqYCGzJlNEB%2Fuploads%2Fgit-blob-2f8c03d5f29adac342d20a466b0657bb11782d03%2Fforms-share-card-01-design-section.png?alt=media" alt="The Share card section in the Design panel: a mini link preview, the Share image URL field with the hint Ideal size 1200×630, and the note that an empty field generates the card from the colors and logo above"><figcaption><p>The <strong>Share card</strong> section. Paste an image URL to override the generated card, or leave it empty.</p></figcaption></figure>

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

<figure><img src="https://3835013762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCy5rSNtQmtqYCGzJlNEB%2Fuploads%2Fgit-blob-02a524c5d9863855769ed12d2f25e7d2f118cdfb%2Fforms-share-card-02-generated-card.png?alt=media" alt="The generated 1200 by 630 share card: the form theme&#x27;s light background, the dForms 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"><figcaption><p>The generated card for a form with a dark theme, a banner and a cover. The Start button takes the form's accent color.</p></figcaption></figure>

## 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 dForms 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 app.dforms.ai) and a start button in the accent color. The button shows the stock word in the form's language (**Start**, or **Comenzar** on a Spanish form), never your custom **Start button text**. The question count is in the same language. |

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**. Without a subheadline the description is *Fill out {name} online.*, or *Completa {name} en línea.* on a Spanish form, where `{name}` is the public title.

## 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.
* **The card follows the form's language.** Chat apps and social networks fetch the card without asking for a language, so a form on **Auto** gets English text. Set the form's **Language** to **Spanish** for a Spanish card. A `?lang=es` link changes the description next to the image, not the image itself. See [Language & button text](/dforms/design/language-and-button-text.md).

## What's next

* [Cover screen & banner](/dforms/design/cover-screen-and-banner.md)
* [Logos, layout & transitions](/dforms/design/logos-layout-transitions.md)
* [Themes, colors & background](/dforms/design/themes-colors-background.md)
* [Your public link](/dforms/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dforms/design/share-card.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.