Button (in rich text)
Insert a call-to-action button inline within body text.
The Button is one of three things you can drop directly into a rich-text field, alongside HTML and media. It places a styled call-to-action button at your cursor with its own link and alignment. Reach for it when a strong "do this next" beats a plain underlined link — a Book tickets button partway through a programme note, for example.
Insert it from the editor's insert menu, where it appears as Button under the Basic group.
Set the link
The button's text and destination live in Button Link, the same link picker used everywhere on your site.
- Label — the text the visitor sees and clicks.
- Choose Internal link to point at one of your own pages, events, people, seasons, series, works, venues, organizations, or posts, or Custom URL to type any external web address. On a multi-site setup, an internal link adds a Site option so you can point at a page on another of your sites.
- Icon — add an optional icon beside the label using the icon picker.
How the button opens (same tab or new tab) is set in the link picker too. See Buttons and links for the full reference.
The button's colour and shape come from a button pattern saved in your theme. The help text reads "Choose a button pattern from your theme. Defaults to the first available pattern." — leave it empty to use the theme's first available style.
Set the alignment
Alignment controls where the button sits on its line: Left, Center, or Right. It is Center by default.
The button has no spacing or background controls of its own — it inherits the spacing of the surrounding text.
Shared controls
The link picker and theme button patterns work the same here as on every other button. See Buttons and links for the full reference, and Themes for where button styles come from and how to change them site-wide.
Published targets only
A button that links to a draft, scheduled, or deleted item will not work on the live site until that item is published. See Drafts, preview, and publishing.
Worked example
To add a centred Book tickets button inside a programme note:
Place your cursor
In the body text, click where you want the button to appear, then open the insert menu and choose Button from the Basic group.
Set the label and destination
In Button Link, type Book tickets as the Label, choose Internal link, and select the event you want from the picker. Pick a button pattern and an optional ticket Icon if you want one.
Set the alignment
Leave Alignment on Center, or switch it to Left or Right to suit the surrounding text.