Button
A link styled as a button, using your Design System button style.
On this page
The Button widget is a link that looks like a button: “Book a consultation”, “See our services”, “Download the brochure”. Its look comes from the buttons in your Design System, so every button on the site stays consistent, and you can still change a single button on the Design tab.

Add a button
Insert it
Click Insert in the rail on the left, find Button under Basic (or type
buttonin Search widgets) and click it or drag it onto the canvas.Write the label and link
Type the Text, or double-click the button on the canvas to edit it there. In Link, paste a URL, type a page name to pick a page of your site, or use a path (
/contact/),#anchor,mailto:ortel:.Choose the style
Pick a Style (Primary, Secondary, Outline, Ghost or Text link) and a Size. Add an Icon and a Hover effect if you like.
To change how Primary and the other styles look everywhere, edit them in the Design System: in the editor, open Styles → Buttons. See Buttons.
Open a popup or a panel
A button's Link can do more than open a page:
#uncoder-popup:open:62opens the popup with ID 62 (use your popup's ID). See Open from a link.#contact-panelopens an Off-Canvas panel with that link anchor.#pricingscrolls to a section or Menu Anchor namedpricing.
Play a video in a lightbox
Paste a YouTube or Vimeo link, or the address of a video file, in Link and turn on Open in a lightbox. The video then plays over the page, so visitors stay where they are, and it stops when they close the lightbox. A link to an image file opens the picture the same way. The lightbox's colors are set once for the site in Styles → Theme → Lightbox (see Lightbox & site behaviour).
For a round play button, choose a play Icon, clear the Text, set Icon spacing to 0, then give the button the same Padding on all sides and a Border radius of 50% in Design → Button. A button without text needs a Label for screen readers, such as “Play the video”, so screen reader users know what it does.
Settings
Settings marked Per device can differ on desktop, tablet and mobile (see Responsive editing). Fields that support dynamic tags can show data such as a post URL (see Dynamic tags).
Content tab
| Setting | What it does |
|---|---|
| Text | The button label. Keep it short and specific, like “Book a consultation”. Supports dynamic tags. |
| Link | Where the button goes: a URL, a page of your site (type to search), #anchor, mailto: or tel:. Link options adds Open in new tab and Add nofollow. Without a link the button is plain text, not a link. Supports dynamic tags. |
| Open in a lightbox | Opens the Link over the page instead of leaving it: a picture, or a video from YouTube, Vimeo or a video file (MP4, WebM…). YouTube plays in privacy mode (youtube-nocookie.com) and Vimeo with its “do not track” option. The video stops when the lightbox closes. |
| Label for screen readers | What the button does, read out by screen readers instead of the button text, for example “Play the video”. Needed when the button shows only an icon, such as a round play button. |
| Style | Which button style to use. Primary and the other styles follow the buttons in your Design System. Options: Primary, Secondary, Outline, Ghost, Text link. Default: Primary. |
| Size | Small, medium, large or extra large. Options: S, M, L, XL. Default: M. |
| Icon | An optional icon next to the text. |
| Icon position | Puts the icon before or after the text. Options: Before, After. Default: After. Shown when an icon is chosen. |
| Icon spacing | Space between the icon and the text. |
| Alignment | Aligns the button. Full width stretches it across its container. Options: Left, Center, Right, Full width. Per device. |
| Hover effect | An animation when the pointer is over the button. Options: None, Lift, Grow, Shrink, Pulse, Shine, Nudge icon, Slide icon through (the icon leaves at one side and comes back at the other), Move icon across (the icon travels over the label to its other side while the label slides into its place, with a slight spring; also on keyboard focus), Reveal icon (the icon appears beside the label), Fill from left, Fill from bottom, Underline, Text roll (the label rolls up and a copy rolls in from below, also on keyboard focus). |
| Button ID | An ID on the button link, for example to track clicks in your analytics tool. |
Design tab
| Setting | What it does |
|---|---|
| Typography | Text style or font, size, weight and spacing of the button text. |
| Normal › Text color | Color of the text. |
| Normal › Background | Background of the button: a color, a gradient or an image. |
| Normal › Border | Border style, width and color of the button. |
| Normal › Shadow | Shadow of the button. |
| Hover › Text color | Color of the text on hover. |
| Hover › Background | Background of the button on hover: a color, a gradient or an image. |
| Hover › Border color | Color of the border on hover. |
| Hover › Shadow | Shadow of the button on hover. |
| Hover › Fill color | The color that sweeps in with the Fill from left and Fill from bottom hover effects. |
| Border radius | Rounds the corners of the button. Per device. |
| Padding | Space inside the button. Per device. |
| Icon size | Size of the icon. Per device. |
| Icon color | Color of the icon. |
| Icon background | Puts the icon in a circle of this color, for example a white circle with an arrow inside a dark button. |
| Icon circle size | Size of the circle around the icon. Shown when Icon background is set. Per device. |
| Icon corner radius | Rounds the corners of the icon's background. Lower it for a rounded square instead of a circle; 0 gives a square. Shown when Icon background is set. Per device. |
Every element also has these sections at the end of the Design tab.
| Section | What it does |
|---|---|
| Spacing & position | Margin, padding, width, alignment in its container, order, position (relative, absolute, fixed), offsets, z-index and global classes. See Spacing, size & position. |
| Background & border | Background, border, border radius, box shadow, overflow and opacity of the whole element. See Colors & backgrounds and Borders & shadows. |
| Mask | Crops the element to a shape (circle, arch, blob, star…) or your own SVG or PNG. See Shape dividers & masks. |
Behaviour tab
The Behaviour tab is the same for every element.
| Section | What it does |
|---|---|
| Anchor & classes | An Anchor ID for #links and your own CSS classes. |
| Animations | Entrance, scroll, hover and loop animations from presets or your own timeline. See Motion & effects. |
| Motion & effects | A simple entrance animation, transforms (also on hover), CSS and backdrop filters, and sticky positioning. |
| Scroll & mouse effects | Movement, rotation, scale, fade and blur while the page scrolls, and pointer effects (follow the pointer, 3D tilt). |
| Visibility | Hide the element on desktop, tablet or mobile, or in dark or light mode. See Visibility. |
| Conditions | Show the element only when rules match, such as logged-in visitors, a date range or a URL parameter. See Display conditions. |
| Interactions | Show, hide or change other elements when this one is clicked, hovered or scrolled into view. See Interactions. |
| Attributes & CSS | Custom HTML attributes and custom CSS for this element. See Custom CSS & attributes. |
Tips
- Say what happens. “Book a consultation” works better than “Click here”, for everyone and for screen reader users who list the links on a page.
- One main action. Use Primary for the most important button in a section and Outline or Text link for the others.
- Full width on phones. Set Alignment to Full width on mobile for an easy tap target.
- Tracking. Give the button a Button ID to count its clicks in your analytics tool.