> ## Documentation Index > Fetch the complete documentation index at: https://docs.startale.com/llms.txt > Use this file to discover all available pages before exploring further. # Embed meta tag > The fc:miniapp meta tag turns any of your shareable pages into a launchable Mini App preview on social platforms. Add an `fc:miniapp` meta tag to the `` 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](https://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: ```html theme={null} ``` ## 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 ```html theme={null} ``` ## Troubleshooting previews Test your embed tag at [app.startale.com/developers/embed](https://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.