Skip to main content
Mini app feed

​
Implementation

Add this meta tag to the <head> section of any page you want to make shareable: 
<!DOCTYPE html>
<html lang="en">
  <head>
    <title>My Mini App</title>
    <meta
      name="fc:miniapp"
      content='{
        "version": "next",
        "imageUrl": "https://example.com/preview.png",
        "button": {
          "title": "Open App",
          "action": {
            "type": "launch_miniapp",
            "url": "https://example.com"
          }
        }
      }'
    />
  </head>
  <body>
    <!-- Your app content -->
  </body>
</html>
The homeUrl used in the manifest must have embed metadata defined, in order for the mini app to render correctly in the Base app.

​
Schema

​
version
string
required
Version of the embed. Use "next" — this is the current recommended version for Mini Apps. ("1" is a legacy value and should not be used.)
​
imageUrl
string
required
Image URL for the embed. Must be 3:2 aspect ratio, maximum 10MB, maximum 1024 characters.
​
button
object
required
Button configuration object.

​
Button Configuration

Defines the launch button that appears on the embed.

​
button.title
string
required
Button text. Maximum 32 characters.
​
button.action
object
required
Action configuration object. Maximum 1024 characters.

​
Action Configuration

Specifies what happens when the embed button is clicked.

​
button.action.type
string
required
Action type. Must be "launch_miniapp".
​
button.action.url
string
App URL to open. Defaults to the full URL of the page including query parameters. Maximum 1024 characters.
​
button.action.name
string
Application name. Maximum 32 characters. Defaults to manifest name.
​
button.action.splashImageUrl
string
Splash screen image URL. Must be 3:2 aspect ratio, between 600x400px and 3000x2000px, less than 10MB, maximum 1024 characters. Defaults to manifest splash image.
​
button.action.splashBackgroundColor
string
Splash screen background color. Must be hex color code. Defaults to manifest splash background color.

Search and Discovery

Learn how your manifest powers search indexing and category placement in the Base app discovery features.

Sharing and Social Graph

Learn how to maximize sharing, social engagement, and viral growth for your Mini App using Base’s social graph features.