Goals

Actions let developers create custom buttons which users can install into their action bar on any Farcaster application. Our goals are:

• Extend casts with custom “cast actions”
• Reuse concepts from the existing frames standard where possible
• Keep it simple

Proposal

1. Actions should appear alongside the common cast actions.
2. When a user clicks an action, a message is sent to the action server.
3. The action server responds with a short text message which is shown to the user.

The mocks below show how Warpcast plans to implement the action button. Initially, only one action will be supported though we will add ways for people to add multiple buttons.

1. Adding actions

Actions are added when a user clicks on a deeplink. The link contains a name, icon, action type and post url, which is all the information a client needs to add the action.

Deep link format v1 [Deprecated]

<aside> ⚠️ We’ve introduced a new format for install URLs. Retrieving metadata from a URL is easier to extend, cross-client compatible, and easy to add to <meta> tags in the future.

See Deep link format v2 below for details.

</aside>