Farcaster Frames

Farcaster Frames are interactive link embeds that let people take simple actions from a Farcaster post. The term is also used loosely for newer in-app experiences, but the distinction matters: the original Frames format and Frames v2 (now called Mini Apps) have different interfaces and capabilities.

Key Facts

  • Original Frames: interactive embeds shown in a post, commonly with an image and buttons that send an action to the Frame’s server.
  • Frames v2: a richer, full-screen in-app web experience; Farcaster renamed this format Mini Apps.
  • What they are not: Frames are not a blockchain, token, or guarantee that a wallet transaction is safe or supported by every client.
  • Compatibility: behavior and available actions depend on the Farcaster client and the app’s implementation.

How the Original Frames Format Works

A creator puts a URL in a Farcaster post. A compatible client reads Frame metadata from the linked page and renders a compact interactive card, often with an image and one or more buttons. When someone selects a button, the client sends the requested interaction to the Frame’s server, which can return the next view or send the user to another page.

This approach made ordinary links more interactive without requiring every experience to be a smart contract. A Frame could show a poll, quiz, game, signup, or NFT mint. The exact features depend on the Frame and the client: seeing a button does not mean every client implements it or that an action can happen without user confirmation.

Frames and Mini Apps

Frames v2 expanded the idea from a compact post card into a fuller web app that opens inside a Farcaster client. The official proposal says Frames v2 was rebranded as Mini Apps without a breaking change to its API or functionality. Current publishing guidance uses a miniapp field in the farcaster.json manifest and retains the older frame field for backward compatibility.

In practical terms, an original Frame is suited to a small interaction attached to a post; a Mini App can provide a more complete interface, multi-step flow, and app-like session. People may still say “Frame” as a broad or historical label, so check whether a page means the original embed or a Mini App when technical details matter.

What People Use Them For

Common examples include polls and quizzes, games, event registration, collecting an NFT, viewing information, or opening a token swap experience. A Frame or Mini App can make these actions easier to discover because the starting point appears beside a post. A client may also provide wallet or sign-in capabilities, but the app must request the relevant action and the user still needs to review prompts and approve any transaction.

Frames do not make an app decentralized by themselves. The linked app may depend on a conventional website, server, APIs, a wallet provider, and one or more blockchains. Nor does publishing a Mini App guarantee broad discovery: official documentation describes a domain manifest and client discovery, while individual clients decide what they support and display.

Limits and Safety

Support differs among clients, and a feature that works in one app may be unavailable or behave differently in another. Developers need to account for those differences and provide a normal web fallback when appropriate. A Mini App’s manifest helps clients identify and display it; it is not a security audit or a promise that the app is trustworthy.

Before using a Frame that requests a wallet connection, signature, or transaction, check the domain and understand what is being approved. A familiar social post can still link to a malicious site. Never treat a Frame button, a verified account badge, or an in-app display as proof that a contract or transaction is safe.

Related Terms

See Also

Sources

Social Media Sentiment

Small Reddit discussions show both enthusiasm for interactive experiences inside social posts and skepticism about whether Frames mostly encourage NFT or token promotion. A newer post describes them as a way to reduce friction for onchain actions, while an older discussion questions the quality of the feed. These are limited examples from different dates, not a representative poll or a measure of current Farcaster usage.

Last updated: 2026-10