Skip to main content
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.
FieldTypeConstraints
versionstringMust be "1".
imageUrlstringPreview image shown in the social feed. HTTPS, 3:2 aspect ratio. Recommended ≤1024 chars.
button.titlestringLabel on the CTA button. Plain text, recommended ≤32 chars.
button.action.typestringOne of "launch_frame" or "view_token".
button.action.namestringApp name shown on the splash screen after the user taps the CTA. Plain text, recommended ≤32 chars.
button.action.urlstringHTTPS launch URL when the button is tapped. Recommended ≤1024 chars.

​
Optional fields

FieldTypeConstraints
button.action.splashImageUrlstringCentered splash icon. PNG, 200×200 px.
button.action.splashBackgroundColorstringHex 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.