Link Widget

The Link widget creates a clickable link to an applet, a page in the current applet, or an external URL. You can show the link as a button, a card, or an article — depending on how prominent it should be on the page.

When to use this

• You want to send the user to a specific page in another applet
• You need a button to navigate between pages in the same applet
• You want to link out to an external website or document
• You want to feature a page with an image and description

How it works

The Link widget has two main choices: Link type (where the link points) and Link style (how it looks). The rest of the settings adapt to those choices — for example, background image settings only show for Card style, and the URL field only shows for external links.

Add a link

1. Open the Design editor for your applet.
2. Add the Link widget to the page.
3. Open the widget settings.
4. Choose a Link type and pick the target.
5. Choose a Link style.
6. Adjust name, icon, description, and other settings as needed.

Widget settings

Source

Setting	Description
Link type	Pick Applet link (another applet in the same app), Page link (a page in the current applet), or External link (URL outside the app).
Link style	Pick Button, Card, or Article. The style controls which other settings are shown.
Applet / Page	For Applet link and Page link — click to choose the target via the target picker.
Address	Only for External link. Enter a full URL (https://...).

Properties

Setting	Description
Name	The text shown on the link.
Icon Settings	For applet and page links — pick None, Standard (the icon from the target), or Own (choose your own icon). Not available for the Card style.
Show Icons	External links only. Toggles the icon on or off.
Icon	Choose an icon when Icon Settings is Own, or when Show Icons is on for an external link.
Thumbnail Settings	For applet and page links — pick None, Standard (the image from the target), or Own (your own URL).
Image URL	Enter a URL for your own thumbnail or background image for the Card style.
Show Description	For Card and Article — shows a description under the name.
Use page description	Only for page links with Show Description enabled. When on, the page's own description is used; when off, you can enter your own in the Description field.
Description	A custom description shown on the card or in the article view.
Open in new tab	Opens the link in a new tab instead of navigating away from the app.
Check visibility	For applet and page links — automatically hides the link if the user lacks permission for the target.

Style

Click Edit style to open the style editor and adjust colors, margins, and other appearance settings for the link.

Example

Scenario: You want a large, clickable info card at the top of the home page that leads to an applet with product information.

1. Add a Link widget to the home page.
2. Set Link type to Applet link and pick the products applet.
3. Set Link style to Card.
4. Enter a name — Our products.
5. Add a background image via Image URL.
6. Turn on Show Description and write a short tagline.

The page now shows a large card that goes straight to the products applet.

Tips

TIP

Use Check visibility for links to applets with restricted permissions. That way, users who can't access the target won't see a link they can't follow.

TIP

For many links in a row — such as a main menu — use the Menu widget instead. It manages several links together and gives a more consistent look.

Common mistakes

WARNING

The Standard setting for an icon or thumbnail pulls the value from the target. If the target has no icon or image, the link looks incomplete — switch to Own and provide your own.

WARNING

External links are not validated automatically. A misspelled URL leads to a 404 — check the address after saving.