carrd og image

Carrd OG image: screenshot, Share Image, or a generated file

Use this page when a Carrd site, or another no-code page, should stop sharing the default screenshot. It compares leaving that screenshot in place, uploading a Share Image by hand, generating one file in OG Pilot, calling the API when you regenerate many pages, and asking an agent to call generate_og_image. Carrd still gets a file. The upload how-to stays on the Carrd social image guide.

Get an API key for the download step below, or install the MCP server so an agent can call generate_og_image for a public Carrd URL. Also see generate one image, the Open Graph debugger, the og:image size cheat sheet, and the API docs.

Five ways to ship the card

Carrd's adding-a-share-image doc (https://carrd.co/docs/sites/adding-a-share-image) says a simple screenshot is shown when a site is shared, and that a Share Image requires Pro Lite or higher. The steps there are Publish, the Media tab, Share Image, Upload, crop, Accept, and Publish Changes. If the site was shared before, Carrd says it may take up to 24 hours because of image caching.

Plan names and yearly prices below are from Carrd's plans page (https://carrd.co/docs/pro/plans): Pro Lite $9/year, Pro Standard $19/year, and Pro Plus $49/year, each listing Share Images. The plan catalog has no per-image price, and this page does not publish an API latency. Queries this page is written for: carrd social image, carrd open graph, carrd og image, carrd share image, custom social image no code, and carrd link preview. The content strategy doc does not publish impression counts for this cluster, so this page does not invent any.

Upload the file in Carrd

These steps follow Carrd's share-image doc. The Carrd social image guide uses the same Publish, Media, Share Image path. Carrd's share-image doc names Upload as the control that selects the file. This page follows that doc. Carrd's Pro plans page lists image and GIF uploads up to 16MB under Large Images and Videos. That line is a general Pro upload limit, not a separate Share Image limit. The share-image doc does not state a pixel size. A completed OG Pilot image is 1200 by 630, which is the width and height in the API JSON.

1. Click Publish.
2. Click the Media tab.
3. Under Share Image, click Upload.
4. Select the image. Use the file you downloaded from OG Pilot.
5. Resize and crop as needed, then click Accept.
6. Click Publish Changes.
7. If the site was shared before, Carrd says it may take up to 24 hours because of image caching.

Download a URL, then upload the file

For one Carrd site, paste the public URL at /new and download the card. You do not need an API key for that form. When the page changes often, or you have many sites, sign a request and download url from the JSON. Get an API key first. The key stays in OG_PILOT_API_KEY. The browser never sees it. The SDK signs the JWT. Do not add a hand-rolled signer.

createImage with json true matches the contract on /docs. Upload nothing in Carrd until status is completed and url is present. image_type selects the delivered file format. A present iat keeps the hosted cache for 24 hours from that timestamp. Omit it and the hosted cache does not expire on its own. A 202 means the render is still going. Retry-After is 30. The share-image doc says to select an image. It does not say a remote URL is accepted, so download the file and upload it. The HTTP call is POST https://ogpilot.com/api/v1/images with the JWT in the JSON field token.

import { configure, createImage } from "og-pilot-js"

configure((config) => {
  config.apiKey = process.env.OG_PILOT_API_KEY
  config.domain = process.env.OG_PILOT_DOMAIN
})

const metadata = await createImage(
  {
    template: "page",
    title: "Your Carrd page",
    description: "The line you want on the card",
    path: "/",
  },
  { json: true, iat: Math.floor(Date.now() / 1000) },
)

curl -X POST "https://ogpilot.com/api/v1/images" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"token":"YOUR_JWT_TOKEN"}'

The same card from MCP

An agent that already has the public Carrd URL can call generate_og_image. The tool takes url and an optional style. It returns image_url. It does not log into Carrd and it does not set Share Image. Download the file and use the upload steps above.

Auth is OAuth 2.1 with PKCE. The config file has no API key. generate_og_image needs a signed-in account with an active plan and a credit. A trial can call the API after the domain is verified. A trial cannot call generate_og_image.

{
  "mcpServers": {
    "og-pilot": {
      "type": "streamable-http",
      "url": "https://ogpilot.com/mcp"
    }
  }
}

generate_og_image
{ "url": "https://example.crd.co" }

How to add a Carrd OG image

1. Leave Share Image unset only when Carrd's default screenshot is an acceptable link preview.
2. For a custom card, download a file from OG Pilot or bring your own, then upload it under Publish, Media, Share Image.
3. Crop, accept, and publish. Carrd says a previously shared site may take up to 24 hours because of image caching.
4. Create an API key and download the JSON url when you regenerate many pages, or install MCP and call generate_og_image with the public Carrd URL.
5. Check the public URL in the Open Graph debugger.

Which Carrd approach should I use for a social image? The screenshot, a Share Image upload, a one-off generate, the API, or MCP. Carrd still receives a file. What does Carrd require for a Share Image? Pro Lite or higher, per Carrd's docs. Does the OG Pilot API publish into Carrd? No. You download the completed url. Can MCP publish a Carrd share image? No. generate_og_image returns image_url for a public page. Will this page publish latency or price benchmarks? This page does not publish an API latency. The plan catalog has no per-image price.