URL button

Updated: Jun 17, 2026

The URL button opens a web page in the Messenger webview. The URL button allows you to enrich the conversation with a web-based experience, where you have the full development flexibility of the web. For example, you might display a product summary in-conversation, then use the URL button to open the full product page on your website.

App links

If the site contains App Links, the button launches the specified native app.

The Facebook Crawler needs to read the app link meta tags for the redirect to work. If you just implemented the tags in your website, you can request a new scrape with the Sharing Debugger Tool. After the crawler has scraped the site, new URL buttons sent should follow the redirect behavior.

Supported usage

The URL button is supported for use with the following:

• Persistent menu
• Generic template
• List template
• Button template
• Media template

Messenger Extensions SDK — required domain allowlisting

To display a webpage with the Messenger Extensions SDK enabled in the Messenger webview you must allowlist the domain, including sub-domain, in the whitelisted_domains property of your bot's Messenger Profile. This ensures that only trusted domains have access to user information available via SDK functions.

For more information on allowlisting domains, see the whitelisted_domains reference.

Properties

Property	Type	Description
type	String	Type of button. Must be web_url.
title	String	Button title. 20 character limit.
url	String	The URL opened in a mobile browser when the button is tapped. Must use HTTPS protocol if messenger_extensions is true.
webview_height_ratio	String	Optional. Height of the webview. Valid values: compact, tall, full. Defaults to full.
messenger_extensions	Boolean	Optional. Must be true if using Messenger Extensions.
fallback_url	String	Optional. The URL to use on clients that don't support Messenger Extensions. If not defined, the client uses the url as the fallback. May only be specified if messenger_extensions is true.
webview_share_button	String	Optional. Set to hide to disable the share button in the webview (for sensitive info). This does not affect any shares initiated by you using Extensions.

Sample request

curl -X POST "https://graph.facebook.com/<LATEST_API_VERSION>/<PAGE_ID>/messages?access_token=<PAGE_ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {
      "id": "<PSID>"
    },
    "message": {
      "attachment": {
        "type": "template",
        "payload": {
          "template_type": "button",
          "text": "Try the URL button!",
          "buttons": [
            {
              "type": "web_url",
              "url": "https://www.example.com/",
              "title": "URL Button",
              "webview_height_ratio": "full"
            }
          ]
        }
      }
    }
  }'

Sample response

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}