Docs

Icon

One icon from the built-in icon libraries or your own SVG.

On this page

The Icon widget shows a single icon, on its own or inside a circle, rounded square or square. Pick from thousands of icons in the built-in libraries (Lucide, Font Awesome, Phosphor, Bootstrap, Feather, Heroicons and Themify), your own icon sets, or upload an SVG. The icon can be a link.

Four icons in a row: a plain leaf, a sofa on a sand-colored circle, a lamp in an outlined rounded square and a ruler on a green square
The Default, Stacked (circle), Framed (rounded) and Stacked (square) views.

Add an icon

  1. Insert it

    Open Insert in the left panel, find Icon under Basic (or type icon in Search widgets) and click it or drag it onto the canvas.

  2. Pick the icon

    Click the Icon field. Choose a library tab, search by name, and click an icon. Upload an SVG uses your own file.

  3. Choose a view

    Keep Default for the icon alone, or pick Stacked (on a filled shape) or Framed (inside an outline) and a Shape.

  4. Position and size it

    Alignment places the icon left, center or right in its container. Set the Size and colors on the Design tab.

Settings

Settings marked Per device can differ on desktop, tablet and mobile (see Responsive editing). The Link supports dynamic tags (see Dynamic tags).

Content tab

Icon
SettingWhat it does
IconThe icon. Pick one from the libraries (Lucide, Font Awesome, Phosphor, Bootstrap, Feather, Heroicons, Themify and your own icon sets), or upload an SVG.
ViewDefault shows the icon alone, Stacked puts it on a filled shape, Framed inside an outlined shape. Options: Default, Stacked, Framed.
ShapeThe shape behind or around the icon. Options: Circle, Rounded, Square. Default: Circle. Shown when View is not Default.
LinkMakes the icon a link. Supports dynamic tags.
Accessible labelName of the icon for screen readers, such as “Call us”. Needed when the icon is a link; leave empty for a decorative icon.
AlignmentPositions the icon left, center or right in its container. Options: Left, Center, Right. Per device.

Design tab

Icon
SettingWhat it does
Normal › Icon colorColor of the icon.
Normal › Shape colorColor of the shape (the fill when stacked, the outline when framed). Shown when View is not Default.
Hover › Icon colorColor of the icon on hover.
Hover › Shape colorColor of the shape on hover. Shown when View is not Default.
SizeSize of the icon. Per device.
PaddingSpace between the icon and the edge of its shape. Shown when View is not Default. Per device.
Stroke widthLine thickness of outline icons (such as Lucide).
RotateRotates the icon.
Shared Design sections

Every element also has these sections at the end of the Design tab.

SectionWhat it does
Spacing & positionMargin, padding, width, alignment in its container, order, position (relative, absolute, fixed), offsets, z-index and global classes. See Spacing, size & position.
Background & borderBackground, border, border radius, box shadow, overflow and opacity of the whole element. See Colors & backgrounds and Borders & shadows.
MaskCrops the element to a shape (circle, arch, blob, star…) or your own SVG or PNG. See Shape dividers & masks.

Behaviour tab

Behaviour sections

The Behaviour tab is the same for every element.

SectionWhat it does
Anchor & classesAn Anchor ID for #links and your own CSS classes.
AnimationsEntrance, scroll, hover and loop animations from presets or your own timeline. See Motion & effects.
Motion & effectsA simple entrance animation, transforms (also on hover), CSS and backdrop filters, and sticky positioning.
Scroll & mouse effectsMovement, rotation, scale, fade and blur while the page scrolls, and pointer effects (follow the pointer, 3D tilt).
VisibilityHide the element on desktop, tablet or mobile, or in dark or light mode. See Visibility.
ConditionsShow the element only when rules match, such as logged-in visitors, a date range or a URL parameter. See Display conditions.
InteractionsShow, hide or change other elements when this one is clicked, hovered or scrolled into view. See Interactions.
AttributesCustom HTML attributes for this element. See Anchor, classes & attributes.

Tips

  • Name linked icons. An icon link has no visible text, so fill in Accessible label (for example “Call the studio”). Leave it empty for purely decorative icons.
  • Your own icon sets. Upload IcoMoon or Fontello sets, or SVG files, in Urmi → Design System → Custom icons; they appear under Custom in every icon picker. See Custom icons.
  • Consistent line weight. Outline icons such as Lucide take a Stroke width; use the same value across the site.
  • Icon with text? Use Icon Box for an icon with a title and text, or Icon List for a list.