Embed metadata transforms your Mini App URLs into rich, interactive previews when shared in social feeds. Instead of plain text links, users will see preview images and launch buttons.

​
Why Embed Metadata Matters

When users share your app’s URL:
  • Rich Previews: Displays your app’s image and description
  • Direct Launch: Provides a button to open your Mini App immediately

​
Implementation by Framework

Next.js 
// app/layout.tsx or page.tsx
export const metadata = {
  other: {
    'fc:frame': JSON.stringify({
      version: "next",
      imageUrl: "https://yourapp.com/preview.png",
      button: {
        title: "Launch App",
        action: {
          type: "launch_frame",
          url: "https://yourapp.com"
        }
      }
    })
  }
}
HTML-based Applications 
<!-- Add to <head> section -->
<meta name="fc:frame" content='{"version":"next","imageUrl":"https://yourapp.com/preview.png","button":{"title":"Launch App","action":{"type":"launch_frame","url":"https://yourapp.com"}}}' />
Both fc:frame and fc:miniapp meta tags are accepted by clients.

​
Next Steps

Overview

Back to the conversion overview

Set Up Manifest

Configure your app’s identity and domain verification

SDK Integration

Access user context and onchain functionality

Test & Deploy

Validate your setup and launch your Mini App