Embed meta tag

Add an fc:miniapp meta tag to the <head> of every page you want to be launchable from a feed (X, Telegram, Discord, Farcaster). When the URL is shared, those platforms render a preview card with a CTA that opens your Mini App. The Startale App validates this tag using its Embed Tool. Use app.startale.com/developers/embed to confirm your tag passes before submitting for listing review.

Tag

All fields are delivered as a single stringified JSON object:

<meta name="fc:miniapp" content='{"version":"1","imageUrl":"...","button":{...}}' />

Required fields

String-length values below come from the Farcaster Mini App spec. They are not enforced by the Startale parser, but staying within them is recommended for consistent display across feeds and the launcher splash.

Field	Type	Constraints
`version`	string	Must be `"1"`.
`imageUrl`	string	Preview image shown in the social feed. HTTPS, 3:2 aspect ratio. Recommended ≤1024 chars.
`button.title`	string	Label on the CTA button. Plain text, recommended ≤32 chars.
`button.action.type`	string	One of `"launch_frame"` or `"view_token"`.
`button.action.name`	string	App name shown on the splash screen after the user taps the CTA. Plain text, recommended ≤32 chars.
`button.action.url`	string	HTTPS launch URL when the button is tapped. Recommended ≤1024 chars.

Optional fields

Field	Type	Constraints
`button.action.splashImageUrl`	string	Centered splash icon. PNG, 200×200 px.
`button.action.splashBackgroundColor`	string	Hex color for the splash background.

Example

<meta name="fc:miniapp" content='{
  "version": "1",
  "imageUrl": "https://your-app.com/preview.png",
  "button": {
    "title": "Play Now",
    "action": {
      "type": "launch_frame",
      "name": "Your App Name",
      "url": "https://your-app.com",
      "splashImageUrl": "https://your-app.com/splash.png",
      "splashBackgroundColor": "#1a1a2e"
    }
  }
}' />

Troubleshooting previews

Test your embed tag at app.startale.com/developers/embed before sharing anywhere.

The image must be reachable over HTTPS with a valid certificate.
Cache headers matter. Feeds reuse stale previews. Set Cache-Control: public, max-age=60 on preview images while iterating.
Test your embed by sharing the URL into a private cast on Farcaster or a saved-messages chat on Telegram.

Overview

Manifest

Runtime

Notifications

Ship it

Tag

Required fields

Optional fields

Example

Troubleshooting previews

​Tag

​Required fields

​Optional fields

​Example

​Troubleshooting previews

Tag

Required fields

Optional fields

Example

Troubleshooting previews