Widget themes
A Widget Theme is a reusable style bundle applied to widgets on your Branded Pages and Sites. Where a Layout Theme styles the page chrome, a Widget Theme styles the widgets themselves (their headers, bodies, icons and type-specific details) so every widget that uses the theme looks consistent.
Creating a Widget Theme
The main form is just the Internal Management section (internal name, description, tags). A new theme starts with sensible defaults for every widget type; you refine the look on the dedicated style pages, listed under the theme's Widget styles tab. You can also start from a bundled preset or an imported theme file: see Theme Files.
The shared shell (General styles)
Every widget sits in the same "shell": a card with an optional header, a content area and an icon. The General styles page controls that shell for all widget types at once, with a live preview:
- Whether to show the header and/or body, and in which order.
- The header and content typography (font, size, weight, color) and alignment.
- The card itself: the border color and width, a per-corner corner radius (up to 60 px, pill-level rounding), an optional shadow (subtle, medium, large, a hard offset shadow or a soft colored one), separate header padding and content padding (horizontal and vertical), and an optional background image.
- The icons: the icon container's size, the icon size, the container's corner radius, and the per-widget-type icons: Audio included.
Effects and text styles
A few options change the character of every card without custom CSS. Each one starts at today's look, so existing widgets don't change until you pick something else:
| Option | Where | Choices |
|---|---|---|
| Surface | Effects | Solid, or Frosted glass, which blurs what is behind the card. Give the header and content backgrounds some transparency to see it. |
| Shadow color | Effects | The color of the hard and soft shadows (black when empty). |
| Button shape | Effects | As today (the icon corner radius), Square, Rounded or Pill, for the copy, open and download buttons. |
| Hover effect | Effects | None, Lift (the card rises), Nudge the buttons or Highlight (a ring in the title color). Movement is skipped for visitors who ask their device for reduced motion. |
| Featured link effect | Effects | None, Pulse or Shine, on the links marked Featured in a Links widget. Skipped for reduced motion too. |
| Title case | Widget header | As written or Uppercase. |
| Title letter spacing | Widget header | From -0.05 to 0.3 em; 0 keeps the font's own spacing. |
| Subtitle and description strength | Widget content | From 40 to 100 %; lower values soften the text against the title. |
Every icon picker on this page offers two groups: Built-in icons (a large curated set that ships with linkable.id) and your own icons from the Brand Vault. Any SVG you upload to the vault shows up automatically. There is nothing to enable, and it does not need to be in a folder. Icons that do sit in a vault folder are listed under that folder's name, which makes a large icon set easier to scan; the rest appear together under Brand Vault.
The Action icons tab styles the small action chips (redirect / copy / download): each one's icon and colors, plus an optional hover background shown while the pointer rests on them (leave it empty for no hover change).
The Click behavior tab sets the default click surface for each of the four link-out widget types (Button, Email, Phone, Whatsapp): just the link icon (the classic behavior), the entire header, or the entire widget. Widgets styled by the theme inherit their type's default and can override it in their own editor; the copy and link icons always stay clickable on top of the larger surface.
Styling per widget type
Some widget types add their own style sub-page: each patches only its own part of the theme, so you can tune one type without affecting the others.
Markdown styles
Typography and colors for Markdown widgets: background, headings H1–H6, paragraphs, links, and inline/multiline code, plus:
- Tables: the header row background and text color, the row background and text color, the striped-row background, the table border color, and a border radius set per corner.
- Blockquote & divider: the blockquote border and text colors, and the divider color.
- Images: a border radius set per corner.
Multiline code blocks take a per-corner border radius too, next to their colors.
Each border radius gives you the four corners separately (top left, top right, bottom right, bottom left), in pixels, so you can round a table, a code block or an image the same way your brand rounds everything else, or round just two corners for a softer, asymmetric look.
The defaults keep the familiar light look Markdown has always had (square tables and images, gently rounded code blocks) so nothing changes until you adjust it. Recolor and round them to make Markdown shine on dark, rounded themes too.
Gallery styles
The slideshow behavior and look:
- Behavior: Autoplay with its interval, and whether to show the arrows and dots.
- Navigation: the arrow background and icon colors, an arrow hover background, and the active/inactive dot colors.
- Slides: the slide transition duration and corner radius.
Autoplay never counts as engagement in your analytics: only a visitor's own navigation is recorded.
PDF viewer styles
Page transition: how a page changes when the viewer shows one page at a time (on phones, or with Single page mode). Turn (the default) turns the page like paper, following the visitor's finger; Slide slides the next page in. Two-page spreads always turn. Restyle the viewer's colors and controls with Custom CSS.
The other types
- Asset download: the resource name, description and file-size text, and the file-type badge.
- Asset showcase: the tile background, border and label text colors for the light and the dark preview surfaces, and the tile corner radius.
- Color palette: the color name, description, type and code text, and the copy-to-clipboard icon.
- Typography: the specimen sample size and color, and whether the weight labels are shown next to each specimen.
- Design tokens: the specimen background, border and corner radius, and the label and value text colors.
- Code snippets: the code block background and text color, the six syntax colors (comments, keywords, strings, numbers, tags and selectors, attributes and names), and the card's background, border color, corner radius, snippet title color, description and usage color, and badge and button text color. The card colors matter on dark pages: without them the title, description and badges take the page's own text color and can disappear against the card.
- Email, Phone, Schedule, WhatsApp: the font color, size and weight for each of these widget types.
Apply a brand palette
Apply brand palette (under More actions (⋯) at the top of the edit page) recolors the whole theme in one step from five palette slots: filled manually, from Brand Vault colors, or prefilled from a Vault folder. Values are copied at apply time, so later Vault edits never restyle the theme silently. See Apply a Brand Palette.
Export, import & presets
A Widget Theme travels as a portable .linkable-theme.json theme file: export one from the list or the edit page, import one as a new theme (or overwrite a theme you own), or start from a bundled preset: Technical Brutalism or Light Minimal. See Theme Files (Export, Import & Presets).
Custom CSS
For anything the settings do not cover, open the theme's Custom CSS tab and write your own CSS. It applies only to the widgets using this theme. You need the Update Custom Css permission. See Custom CSS for the hooks and variables you can target.
Restyle with Claude
On plans that include the AI connector, you can also create and restyle Widget Themes conversationally from Claude: "make my widget cards dark with rounded corners". Claude only applies valid values, and changes go live immediately like panel edits. See Connect Claude.
Sharing and deleting
You can share a Widget Theme with other workspaces (read-only for the recipient) and replicate one as a starting point. A theme that is in use by any widget is protected from deletion. Trashed themes open read-only; restore to edit, or force-delete to remove permanently.
With Claude
With the Claude connector, Claude can read a Widget Theme, create one and change its settings: the card, header, icons, text and each widget type's styles. It reads the theme's schema first, so it only sends settings the panel accepts.
- Connection permissions: View widget, layout and QR themes; Create and update widget, layout and QR themes to change them. Your role's permissions still apply.
- Goes live: a saved theme shows on every widget using it at once.
- Stays in the panel: deleting themes, theme files (export, import, presets) and Apply brand palette.
Try asking:
- "Create a widget theme with square corners, no shadow and titles in our brand orange."
- "Make the download buttons in the 'Resources' widget theme orange with white icons."
- "Give our widget theme frosted glass cards, pill buttons and a lift on hover."
- "Make featured links shine and titles uppercase with wide letter spacing."