Docs
Get started

Tappable URL buttons on WhatsApp

The URL button is the cleanest way to drive a customer from WhatsApp to your website, Calendly, checkout or anywhere else with a public link. One tap, no copy-paste, no broken underline-as-link weirdness.

Overview

Plain text links in WhatsApp are clickable but ugly. They underline, they fall through the keyboard, customers worry they're phishing. The URL button replaces all of that with a real button at the bottom of a card. Hero image up top, your copy in the middle, a labeled call-to-action button at the bottom. Same engagement as a paid Meta ad placement, from your conversations inbox.

★

Use URL buttons as the safest cross-device fallback. When other button types behave weirdly on iOS during beta, URL buttons render natively on both Android and iOS.

Command syntax

#ButtonMix|Title|Subtitle|image*IMAGE_URL|url*ButtonText*https://destination.example.com

Field by field

  1. #ButtonMix declares a button message.
  2. Title shows in bold above the image.
  3. Subtitle shows under the title as body text.
  4. image*IMAGE_URL attaches a hero image (JPG, up to ~5 MB).
  5. url*ButtonText*DestinationURL defines the link button:
    • ButtonText is the label of the button (for example Book a call).
    • DestinationURL is the absolute URL the customer is sent to.

Example

A booking card pointing to a Calendly page:

#ButtonMix|Talk to our team|Pick a slot, hop on a 20-min call.|image*https://cdn.example.com/calendar.jpg|url*Book a call*https://calendly.com/acme/intro

Result on WhatsApp

  1. The recipient sees a card with image, title and subtitle.
  2. A button labeled Book a call sits at the bottom.
  3. Tapping the button opens the URL in the customer's browser.
  4. WhatsApp also caches a preview of the destination if it has open graph tags.

Important notes

  1. The image must be .jpg. PNG, GIF and WebP fail silently.
  2. The destination URL must include the protocol (https://). Bare domains don't work.
  3. Maximum file size depends on your CRM. Typically 5 MB. Check your HighLevel integration.
  4. Keep button text under 20 characters for clean rendering. Book a call, Get the guide, See plans.
  5. UTM parameters work as expected. Tag every URL button so you can see WhatsApp conversions in your analytics.
!

The URL must be public. Anything behind a login wall (such as an internal staging URL) will open but the customer will hit your login page. Use a public marketing link.

Troubleshooting

The card sends as plain text

The command was malformed or sent from the WhatsApp app instead of the CRM. Send it from the Conversations tab of your CRM. Make sure the command is the only content in the message body.

The image doesn't render

Open the image URL in an incognito window. Must be public, must end with .jpg or .jpeg, must be HTTPS, must be under 5 MB. Convert from PNG with ImageMagick or any image tool before uploading.

The button is there but doesn't open the URL

Triple-check the URL syntax. Common mistakes: missing https://, extra space inside the URL, special characters (use percent-encoding for anything beyond ASCII). Test the URL in a browser by copy-pasting it as-is.

★

Combine URL buttons with Spintax on the title or subtitle to give every recipient a slightly different card. Same destination, varied copy, lower spam footprint.

Was this page helpful?