A button can show an icon beside its label: an arrow on "Shop now", a cart on "Add to bag", a
play symbol on "Watch the film". The icon is part of the button, not a separate layer, so it moves,
resizes, animates and exports with it. You never have to line it up by hand.
To add an icon
- Select the button on the canvas.
- In the Properties panel on the right, find the Text section. The icon rows sit under Color.
- Turn on Add icon. The icon picker opens.
- Click an icon. It's on the button straight away: there's no confirm step, and Undo takes it back if you picked the wrong one.
A first icon goes after the label, where an arrow points, with a gap of half the label's font size between them.
Choose an icon
The picker has two tabs.
a. Stock icons The icon library.
Type in Search icon to search by name and tags, or open Filter by category to pick one or more categories. Each one you pick shows as a chip under the search, and Clear removes them all.
Recommended for buttons comes first: icons we've picked because they read well at button size, such as arrows, carts and play symbols. Each one is also listed in its own category. Icons marked premium open the upgrade options instead of being added, if your plan doesn't include premium elements. If your team's Brand Control hides icons, this tab isn't shown and the picker opens on your Brand Kit.
b. Brand kit
The SVG files in your design's Brand Kit, with its folders and a search (Search elements). Only SVGs are listed, because those are the only files a button can draw as an icon. If the design has no Brand Kit, the tab says so. If the design is a brand template limited to one Brand Kit folder, the tab opens on that folder and stays inside it
Using your own icon
To use an icon of your own, add the SVG to your Brand Kit first, then pick it from the Brand kit tab.
Which SVGs work
A button can use almost any SVG. A file is denied from upload, with the message "This icon can't be used on a button. Pick another one.", when it:
- is animated (the animation couldn't play the same way in every download);
- links to a file outside itself, such as an image or a font it doesn't contain;
- has no size to read its proportions from (no viewBox, and no width and height).
Re-export the icon without these and it will work.
Icon position and Icon spacing
Once a button has an icon, more options appear under Add icon:
- Icon position: icon on the left or on the right of the label.
- Icon spacing: the space between the icon and the label, from 0 to 200 px.
The spacing is kept in proportion to the label's font size. Make the text bigger and the spacing grows with it, so the button keeps its look at every size.
Icon size
The icon is as tall as the label's font size. Long and tall icons keep their own proportions inside that square. There's no separate size setting: to make the icon bigger or smaller, change the label's font size, and the icon follows.
The button makes room for the icon too. A button that sizes itself to its label widens to fit the icon and the spacing
Color: Match text color
Match text color decides what colour the icon is drawn in.
- On: the icon takes the label's colour, including its hover colour. A multi-coloured icon becomes a one-colour silhouette, but keeps any see-through parts it has.
- Off: the icon keeps its own colours. A colour swatch appears next to the switch. Pick a colour there to draw the whole icon in that one solid colour instead.
Turn Match text color back on and off again to bring back the icon's original colours after picking one. The picker sets a sensible starting point. A plain one-colour icon (black, grey or a single dark shape) starts with Match text color on. An icon with several colours, like a logo, starts with it off.
The hover style has no icon settings of its own. With Match text color on, the icon changes to the label's hover colour along with the text.
Replace or remove the icon
- Replace: click Replace on the Add icon row, or click the icon's preview next to it. The picker opens as Replace icon. The new icon keeps the old one's position, spacing and colour setting.
- Remove: turn off Add icon.
A button with only an icon
Delete the button's label text and the icon stands on its own, centred, with no spacing. The Icon spacing row hides while there's no label. If you type a label again, the spacing you had comes back. Screen readers need a name for a button they can't read text on. Give it one in the Accessibility section. Without one, the layer's name is used, so make sure the layer is named something meaningful, like "Play video".