The Share on WhatsApp block, setting by setting

Every setting on Beacon Messenger's Share on WhatsApp block: the message template, {title} and {url}, three styles, three sizes, alignment, and where it works beyond product pages.

We have written before about why a share button matters, in the post on turning WhatsApp shares into traffic you can see. This one is narrower and more practical: it goes through every setting on the Share on WhatsApp block in Beacon Messenger, says what each one does on the page, and covers the two things people ask about most, which are what happens on pages that are not product pages and how to make the button match the theme.

What the block is

The share block is a theme app block. In the theme editor you add it to any section that accepts app blocks, the same way you would add a text or image block, and remove it the same way. It renders one link styled as a button. There is no JavaScript: the link points at WhatsApp's share address with your message already encoded into it, so tapping it on a phone opens WhatsApp with the message ready, and clicking it on a desktop opens WhatsApp Web or the desktop app. The link opens in a new tab so the shopper does not lose your page.

Because it is a plain link, it adds nothing measurable to page weight and cannot break when a script fails. It also means there is nothing to configure beyond the five settings below.

Label

The text on the button. The default is Share on WhatsApp. Shorter labels work better next to Add to cart: Share, Send to a friend, or just WhatsApp with the icon doing the rest. The icon is always shown and sits to the left of the label at a size that scales with the font.

Message

The message is what appears in the shopper's WhatsApp composer, and the shopper can edit it before sending. The default is Check this out: {title} {url}. Two placeholders are replaced when the page renders:

  • {title} becomes the product title on a product page. On any other page it becomes the page title, and if the page has no title it falls back to the shop name.
  • {url} becomes the full address of the current page, including your domain. On a product page it is the product's canonical address; elsewhere it is the path of the page being viewed. Query strings are not included, so a shopper who arrived with tracking parameters in the address shares a clean link.

Everything else in the message is passed through as written, so you can add a line break, a short pitch, or your own tracking parameters after {url}. Keep it short: WhatsApp previews the link below the text, so the title and a one line nudge are usually enough. The message is URL-encoded for you, so apostrophes, accents and emoji are safe to type.

Style: solid, outline or text

The three button styles
StyleHow it looksWhen to use it
SolidWhatsApp green background, white text. Lightens slightly on hover.Pages where sharing is the main action, such as a gift guide or a wishlist page.
Outline (default)Transparent background, thin green border, dark green text. Fills with a pale green on hover.Product pages, where it should be visible but clearly secondary to Add to cart.
TextNo background or border, just icon and label. Underlines on hover.Dense layouts, footers, or beside other share links where a button would be too heavy.

All three are pill shaped and use your theme's font, inheriting the font family so the button never looks pasted in from another site. The green is WhatsApp's own, which is what makes the button recognisable at a glance; the block does not expose a colour picker on purpose.

Size: small, medium or large

Size changes the padding and the font size together. Small is a compact chip at roughly thirteen pixel text, medium is a standard button at fifteen, and large is a full width candidate at seventeen. Medium is the default. If the button sits in a row with your theme's own buttons, pick the size whose height is closest to theirs; the theme editor preview makes this a two second comparison.

Alignment: left, center or right

Alignment positions the button within the width of its block. Left is the default and is right for most product page layouts, where everything else is left aligned. Center suits a block placed on its own below the product description or on a blog article. Right is occasionally useful in a two column layout where the button should sit under the price. Alignment does not stretch the button; it stays as wide as its label.

Where the block works beyond product pages

Because the block can be added to any section that takes app blocks, it works on more than product pages, and the {title} and {url} placeholders adapt. On a collection page the message carries the collection's title and address, which is a good fit for a seasonal edit or a sale collection. On a blog article it shares the article. On the home page it shares the shop name and front page. The one thing to avoid is placing it inside a section that repeats, such as a product grid, because you would get one button per card rather than one for the page.

On product pages the natural spot is directly under the buy buttons or at the end of the description, where a shopper who is hesitating is most likely to ask someone. Our guide to the theme editor settings for the chat widget covers the companion embed; the two are independent and you can use either without the other.

A quick checklist

  1. Add the block to the section under the buy buttons and leave the style on outline.
  2. Shorten the label if your buy buttons are short, and keep the message to one line plus the placeholders.
  3. Set the size so the button height matches Add to cart, then set alignment to match the surrounding content.
  4. Preview on a phone in the theme editor and tap the button once to see the composed message.
  5. If you want to measure shares, add UTM parameters after {url} as described in the attribution post.

Questions about the share block

Does the share button need the chat widget or the WhatsApp Cloud API connection to work?

No. The share block is a plain link that opens WhatsApp on the shopper's own device with a prefilled message. It does not send anything through your business number and works with or without the chat widget or notifications set up.

Can I change the green colour of the button?

Not in the block settings. The three styles use WhatsApp's green so the button is recognisable. The text style is the quietest option if the green feels too strong in your layout, and your theme's font is used in all three.

What does {url} contain on a product page a shopper reached with a discount link?

The product's address without the query string. Parameters the shopper arrived with are not carried into the shared link, which keeps shared links clean and keeps someone else's tracking out of the message.

Can I use the block on a collection or blog page?

Yes, anywhere the theme editor lets you add an app block. {title} becomes the page title and {url} the page address, so the shared message describes the collection or article rather than a product.

More guides