Skip to content

Theme files (export, import and presets) ​

Widget Themes and Layout Themes can travel as theme files: portable .linkable-theme.json files that contain every style setting. Use them to move a look between workspaces or environments, keep a backup of a design milestone, hand a finished look to a client, or start from a bundled preset. Everything on this page works the same for both kinds; the file itself records which kind it holds.

Exporting a theme ​

Export theme is available on every row of the themes list and in the header of the theme's edit page. It downloads a JSON file named after the theme and its kind:

  • summer-campaign-widget-theme.linkable-theme.json
  • summer-campaign-layout-theme.linkable-theme.json

The file carries the theme's name, description and its complete style settings, including the current defaults for anything you never customized: so importing it reproduces the look exactly, even from themes created before the newest style controls existed.

You can export a theme that was shared with you read-only. Importing that file creates your own fully editable copy.

What a theme file does not carry ​

  • Media files: a logo, favicon or background image is never embedded. The file notes which of these the theme had, so you know what to re-attach after importing.
  • Custom asset icons: icons based on a Brand Vault asset are reset to their defaults in the file (those assets belong to the source workspace). The import tells you when this happened.
  • Brand Vault fonts: a layout font slot using a vault family is saved in the file by its family name. On import, if the destination workspace's vault has a family with that name (its own, or one shared into it), it links up automatically; otherwise the slot falls back to the default Google font and the import tells you, import or upload the family into the vault (or have the owner share it), then set the slot again. (A name that matches a Google font falls back to the Google-hosted version of the same typeface, silently.)

Importing a theme ​

Import theme sits in the header of the themes list. Upload a .linkable-theme.json file and choose Import as:

  • New template (the default): creates a new theme from the file, named after it. Names are de-duplicated automatically ("Name (2)").
  • Overwrite an existing template: replaces the style settings of a theme you pick, keeping its name, media and sharing. Only themes owned by your workspace can be overwritten: shared and trashed ones are never offered. The confirmation tells you how many items currently use the theme, because they all change appearance the moment you confirm.

If your plan's template limit is reached, importing as a new theme is blocked: but you can still import by overwriting.

Nothing is applied blindly ​

Theme files are validated value by value on import:

  • Unknown or invalid values are skipped and reported: the notification lists exactly which settings were ignored; everything valid is still applied.
  • A file of the wrong kind is rejected and points you to the right section (a widget-theme file can't become a layout theme).
  • Files that aren't valid theme files, files created by a newer version of linkable.id, and files larger than 512 KB are rejected outright.

Starting from a look ​

Start from a look (under More actions (⋯) on the Layout Themes and Widget Themes lists) creates a matching pair, a Layout Theme and a Widget Theme, from one of six ready-made looks. The picker shows a small preview of each:

LookStyle
AndesDark, with an orange accent and a soft glow: the linkable.id look.
BoldBright yellow, thick black borders and hard shadows.
CleanSoft gray, white rounded cards and a blue accent.
EditorialWarm paper, a serif headline and square edges, like a magazine page.
GlassFrosted cards over a violet-to-pink gradient, with pill buttons.
TerminalGreen on black, a monospace font and a faint grid.

Each look uses the newer options (backgrounds, entrance motion, button shapes, hover and featured effects, grouped contact rows), so it's a quick way to see them together. Both themes are your own copies: they don't change if the bundled look does, and you can edit, rename and share them like any other theme. Apply them to a page (its Layout Theme, and its widgets' Widget Theme) to use the look. You need permission to create both kinds of theme.

Starting from a preset ​

New from preset (next to Import in the list header) creates a theme from a bundled starter look:

  • Technical Brutalism: the linkable.id default look: strong borders and technical contrast.
  • Light Minimal: a clean, light look with soft grays and rounded panels.

Both presets exist for Widget Themes and for Layout Themes, and they go through the exact same import pipeline as a theme file. The result is a normal theme: rename it, restyle it and share it freely.

With Claude ​

Claude can't export or import theme files yet: that stays in the panel. Through the Claude connector it can read a theme's settings and create a copy of it in the same workspace, and start from a look: it lists the six looks, creates the pair you pick and applies it to a page and its widgets. Try asking: "Give my business card page the Glass look."