Buttons help visitors move around your project and take action. Use a button to take visitors to another page or section, or to an external website. You can also use it to start an animation or open an email app so visitors can contact you. A button stands out more than a text link, so save buttons for the actions you most want visitors to take.
Add a button
Click + in the left dock (or press W) and select Button.
Button appearance
Click the button to open its settings on the right side of your screen. From there you can change:
- Shape: Choose Rectangle, Square, or Ellipse.
- Color: Set the button and text colors.
- Radius: Round the corners of a Rectangle or Square.
- Border: Add a border and set its color and thickness.
- Text style: Choose a font, its weight (if available), and text size. You can also change the letter spacing and baseline shift, and add padding.
- Hover state: Change how the button looks when a visitor points at it. See “Set a hover state for the button.”
- Current state (appears only when the button is fixed on all pages): Change how the button looks when it links to the page the visitor is on. See “Set a current state for the button.”
Widgets are synchronized across Desktop, Tablet, and Mobile layouts, so changing a button's text in one layout changes it in the others. To give a button different text or font sizes in each layout, copy the button and name the copy (for example, Button_mob). Then use the eye icon to hide the desktop button in the Mobile layout and the mobile button in the Desktop layout. The Desktop keyhole lets you check how changes in Mobile affect Desktop.
Set a hover state for the button
A hover state changes how the button looks when a visitor points at it.
- Open the button's settings.
- Switch from Default to Hover.
- Change the shape color, add a border, and set the border and text colors. Adjust the transition setting to control how fast the button switches to its hover state.
To check the effect, open Preview (the eye icon in the bottom-left corner) and point at the button.
Set a current state for the button
In addition to Default and Hover, you can also set a third state: Current. The Current state changes how the button looks when the visitor is on the page the button links to. For example, if a button links to page 5, you can give it a Current style. When a visitor is on page 5, the button shows that style. On every other page, it shows its Default style.
For the Current state option to appear in the button's settings, the button must meet two conditions:
- It’s set to appear on all pages.
- It has a link.
If your project has only one page, you can still set up the Current state, but it won’t have a visible effect.
Add an icon to the button
Click Icon in the widget controls to add a graphic symbol from the built-in selection, such as an arrow or a download symbol. You can then:
- change the icon's size and color;
- place it to the Left or Right of the text;
- change its color on hover.
If you add an icon and remove all the button text, the icon will automatically be centered.
Add a link to the button
To make the button take visitors somewhere, select it and click Link in the widget controls. Then choose a destination:
- Page in this project: go to another page in your project.
- External URL: open a website. Include https:// at the start.
- Anchor: scroll to a section on the same page.
- Email: open the visitor's email app with your address filled in.
Turn on Open in a new tab to keep your project open when visitors follow an external link.
Animate your button
Use animations to make your button react to visitors or to bring other parts of your page to life. You can animate the button itself, for example, to scale or hide after a visitor clicks it. You can also use the button as a trigger so that clicking it starts an animation on another element on the page, like revealing an image or sliding in a text block.
To set this up, select the button and click Animations in the widget controls. Learn more in our Animation article.
Add a custom cursor to the button
You can set a custom cursor for your button so the cursor changes when a visitor clicks or hovers over it. It's a simple way to make the button feel more interactive and on-brand.
Custom cursors only appear on devices with a mouse or trackpad, not on touchscreens.
FAQ
Can I use different text or icons for the same button on different layouts?
No. A button's text and icon are synchronized across all active layouts, so editing them in one layout changes them everywhere. However, style and position aren't synchronized: you can change the color, size, and placement in each layout separately. To show different text or a different icon in another layout, use a separate button for that layout. Learn more in our Widgets in different layouts article.
Can I make an icon-only button?
Yes. Just add an icon to your button, then delete all the text.
Can I upload my own icon to a button?
No, you can only choose from the built-in icon menu. If you’d like to use your own icon, as a workaround, you can create a button from a shape, add a file containing your icon, and add a link to it.
Are there ready-to-use buttons?
Yes. Click + in the bottom-left panel (or press W), then go to Presets → Buttons. Click the button you like to add it to your page, then edit it.
Can I reuse my button in other projects?
Yes. Select your button and click Save to presets in the right panel. To use it later, click + in the bottom-left panel (or press W) and go to Presets → Saved.