Skip to content

CSS personalizado ​

El CSS personalizado te permite cambiar el estilo de lo que los ajustes del tema no cubren, con tu propio CSS en un tema de estructura (toda la página) o en un tema de widgets (solo los widgets que lo usan). Se aplica después de los estilos del propio tema, así que las reglas normales ganan sin !important.

Disponibilidad: cuentas con el CSS personalizado activado; escribirlo requiere el permiso Update Custom Css.

Quién puede usarlo ​

El CSS personalizado necesita el permiso Update Custom Css en tu rol, además de poder editar el tema; sin él puedes ver el CSS pero no cambiarlo. Los superadministradores lo tienen por defecto; dáselo a otros roles en Configuraciones → Roles. Un tema compartido con tu workspace desde otro sigue siendo de solo lectura.

Dónde escribirlo ​

  • Tema de estructura: abre el tema y ve a la pestaña CSS personalizado. El CSS se aplica en todas las páginas que usan el tema. Usa Vista previa para verlo antes de guardar.
  • Tema de widgets: abre el tema y su pestaña CSS personalizado. El CSS se aplica solo a los widgets que usan este tema: cada regla queda limitada a ellos automáticamente, así que no puede cambiar nada más de la página. Escribe :scope para referirte al propio widget, por ejemplo :scope:hover .lk-widget-title { color: #b45064; }. La vista previa sobre el editor muestra tu borrador.

A qué apuntar ​

Apunta a las clases lk-* y a las variables --lk-* de la Referencia de CSS de temas, que describe cada una: qué es, dónde está en la página, sus estados y las variables que la estilizan. Son un contrato estable: siguen funcionando cuando linkable.id cambia su propio código. Otros nombres de clase que veas en la página (utilidades de diseño como flex o px-5) pueden cambiar en cualquier momento; no dependas de ellos.

Las variables llevan los valores del propio tema. Redefine una para cambiarla en todos los lugares donde se usa, por ejemplo :root { --lk-header-background-color: #1f2937; } en un tema de estructura, o :scope { --lk-w-title-color: #b45064; } en un tema de widgets.

Qué estiliza cada clase principal ​

ClaseQué es
lk-pageEl <body> de la página; también lleva data-lk-layout-theme
lk-layout--entry, lk-layout--site, lk-layout--fullscreenEl contenedor de la página, según el tipo de página
lk-header, lk-header-inner, lk-header-logoLa barra superior, su fila de contenido centrada, el espacio del logo
lk-header-link, lk-header-link-text, lk-header-link-iconUn enlace de la barra superior, su texto, su ícono
lk-header-drawer, lk-header-drawer-link, lk-header-iconEl panel del menú en el teléfono, sus enlaces, los íconos de menú y cerrar
lk-submenu, lk-submenu-buttonLa barra bajo el encabezado en pantallas pequeñas, sus botones
lk-content, lk-widgetsLa columna de contenido, la pila de widgets dentro de ella
lk-sidebar, lk-sidebar-title, lk-sidebar-entry (--active), lk-sidebar-categoryEl menú de páginas de un sitio, su título, un enlace a página (la actual), una categoría
lk-outline, lk-outline-link, lk-outline-sublink, lk-outline-dropdown"En esta página", sus enlaces, los enlaces a títulos, su desplegable en el teléfono
lk-pagination-link, lk-pagination-label, lk-pagination-titleLas tarjetas de anterior / siguiente al final de una página de sitio
lk-card-show, lk-card-button (--primary, --secondary), lk-card-chips, lk-card-installUna página de tarjeta de presentación: la vista con la que abre desde la pantalla de inicio, sus botones, el botón Compartir y los pasos de instalación
lk-widget (lk-widget--{tipo}, por ejemplo lk-widget--email)La tarjeta de un widget; en un tema de widgets es :scope
lk-widget-header, lk-widget-icon, lk-widget-titleLa barra de encabezado de la tarjeta, su ícono, su título
lk-widget-action--clipboard, --redirect, --download, --asset-downloadLos botones de acción del encabezado (copiar, abrir, descargar)
lk-widget-body, lk-widget-content, lk-widget-subtitle, lk-widget-briefEl cuerpo de la tarjeta, su contenido con márgenes, el subtítulo, la descripción

Cada tipo de widget agrega sus propias clases, por ejemplo lk-email-value, lk-gallery-nav, lk-palette-swatch o lk-markdown. La Referencia de CSS de temas lista cada clase y variable, por área y tipo de widget.

El widget Markdown conserva también la clase markdown-body; su hoja de estilos integrada apunta a .markdown-body …, así que reemplaza esas reglas con un selector al menos igual de específico, o redefine sus variables --md-*.

Páginas de tarjeta de presentación ​

Una página en modo tarjeta de presentación agrega las clases lk-card-*. Sus colores y el radio de las esquinas vienen del tema del widget de Contacto de la página (su botón de descarga para los botones principales, su borde, su fondo y los colores de texto), y sus fuentes, de la página, con estas variables en .lk-card-ui: --lk-card-radius, --lk-card-button-radius (las esquinas de los botones: la forma de botón del tema, o si no el radio de las esquinas), --lk-card-primary-background, --lk-card-primary-color, --lk-card-primary-border, --lk-card-hover-background, --lk-card-surface, --lk-card-text, --lk-card-muted, --lk-card-border. Redefine una en una regla .lk-card-ui, o estiliza las clases directamente, por ejemplo .lk-card-button { text-transform: uppercase; }.

El visor de PDF ​

El visor del widget PDF tiene sus propias clases y variables (Widget PDF en la referencia). Escríbelas en el tema de widgets que usan tus widgets PDF:

  • lk-pdf es el visor completo; lk-pdf-toolbar la barra con el contador de páginas (lk-pdf-counter) y los botones (lk-pdf-button); lk-pdf-stage el área alrededor de las páginas; lk-pdf-page cada página; lk-pdf-arrow las flechas grandes de anterior y siguiente; lk-pdf-panel los paneles Páginas, Contenido y Buscar, con lk-pdf-thumb, lk-pdf-toc-item y lk-pdf-search-result dentro.
  • Estados: lk-pdf--fullscreen mientras el visor está en pantalla completa, lk-pdf-panel--open en el panel abierto, lk-pdf-thumb--current en la miniatura de la página actual.
  • Variables, en una regla :scope: --lk-pdf-background (detrás de las páginas), --lk-pdf-toolbar-background, --lk-pdf-toolbar-color (texto e íconos), --lk-pdf-accent (anillos de foco, la miniatura actual, el indicador de carga), --lk-pdf-button-hover-background, --lk-pdf-control-radius (botones y flechas), --lk-pdf-page-background, --lk-pdf-shadow, --lk-pdf-panel-background, --lk-pdf-panel-color, --lk-pdf-turn-duration (cuánto dura el paso de página, por ejemplo 400ms; hasta 3s) y --lk-pdf-shadow-strength (la luz y la sombra al pasar la página, de 0, sin ellas, a 1, el valor predeterminado).

El visor también usa clases que empiezan con afb y variables que empiezan con --afb. Son internas y pueden cambiar; usa las de lk-pdf.

Imágenes del Brand Vault ​

Para usar una imagen de tu Brand Vault, escribe url(vault:ID) con el id del recurso, por ejemplo .lk-page { background-image: url(vault:42); }. Para encontrar el id, abre el recurso en el Brand Vault: es el número en la barra de direcciones (…/brand-vault/42/edit); Claude también lo devuelve cuando lista tus recursos. Solo se pueden usar imágenes e íconos de tu propio workspace. Cada visitante recibe un enlace nuevo y firmado al archivo.

Ejemplos ​

Un tema de estructura con un encabezado más delgado y de marca, y tarjetas de widgets redondeadas en toda la página:

css
.lk-header { border-bottom-width: 3px; box-shadow: none; }
.lk-header-link-text { letter-spacing: 0.04em; text-transform: uppercase; }
.lk-widget { border-radius: 16px; }
@media (max-width: 640px) {
  .lk-content { padding-top: calc(var(--header-height, 80px) + 1rem); }
}

Un tema de widgets cuyas tarjetas se elevan al pasar el cursor y cuyos títulos siguen un color de marca:

css
:scope { transition: transform 150ms ease, box-shadow 150ms ease; }
:scope:hover { transform: translateY(-2px); box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12); }
:scope { --lk-w-title-color: #b45064; }

Un tema de widgets para los widgets PDF: una barra con los colores de la marca, páginas redondeadas y pasos de página más rápidos:

css
:scope {
  --lk-pdf-background: #f4f1ec;
  --lk-pdf-toolbar-background: #1f2937;
  --lk-pdf-toolbar-color: #ffffff;
  --lk-pdf-accent: #e85d04;
  --lk-pdf-turn-duration: 400ms;
}
.lk-pdf-page { border-radius: 8px; overflow: hidden; }
.lk-pdf-button:hover { color: #e85d04; }

Un fondo de página desde el Brand Vault, y un token de un sistema de diseño en tu propia regla:

css
.lk-page { background-image: url(vault:42); background-size: cover; }
.lk-header { border-color: var(--brand-primary); }

Lo que no está permitido ​

El CSS se revisa al guardar. Si algo no está permitido, no se guarda nada y ves la línea y el motivo; nunca se quita nada en silencio.

  • Hasta 64 KB para un tema de estructura y 32 KB para un tema de widgets.
  • url() solo para una imagen del Brand Vault (url(vault:ID)) o una imagen o fuente data:. Las direcciones de otros sitios se rechazan, así tus páginas nunca hacen que el navegador de tus visitantes contacte a terceros.
  • No se permite: @import, @font-face (las fuentes vienen de los ajustes de fuentes del tema), @charset, @namespace, @page; image-set(), cross-fade(), image(), src(), expression(); el carácter <; barras invertidas (escapes de CSS); anidar CSS con &.
  • Reglas @ permitidas: @media, @supports, @keyframes, @container, @layer. En un tema de widgets, los nombres de @keyframes se vuelven únicos para ese tema automáticamente; sigue usando el nombre que escribiste.

Bueno saber ​

  • Guardar publica. Como cualquier cambio de tema, el CSS guardado se ve de inmediato en todas las páginas que usan el tema. Revísalo antes (temas de estructura: Vista previa; temas de widgets: la vista previa sobre el editor).
  • No hay historial. Antes de un cambio grande, copia el CSS actual en un lugar seguro; para deshacerlo todo, vacía el campo y guarda.
  • Qué CSS gana. Ajustes del tema < tu CSS del tema de estructura < tu CSS del tema de widgets para sus propios widgets (sus reglas son más específicas). Dentro de una misma hoja, gana la regla posterior a igual especificidad.
  • Markdown y fragmentos de código. La tipografía del widget Markdown y los colores de sintaxis de los fragmentos de código usan reglas más específicas que las demás clases ([data-lk-widget-theme] .lk-markdown h1); iguala esa especificidad, o redefine sus variables (--md-*, --cs-*, --lk-w-h1-color, etc.).

Sistemas de diseño ​

Un sistema de diseño importado al Brand Vault (el modelo usado hasta octubre de 2026) creaba conjuntos de temas cuando se publicaba una versión. Su tema de estructura recibía los colores y tokens del sistema en su CSS personalizado como variables (por ejemplo --brand-primary), entre dos comentarios que marcan una región. Úsalas en tus propias reglas: .lk-header { border-color: var(--brand-primary); }. Ya nada actualiza esa región (la importación se retiró en noviembre de 2026), así que edítala como el resto de tu CSS.

Trabajar con una IA ​

Con Claude, a través del conector. Claude puede leer y escribir CSS personalizado cuando tu conexión tiene el permiso Escribir CSS personalizado en los temas de widgets y de estructura (vuelve a conectar el conector para aprobarlo) y tu rol tiene Update Custom Css. Claude lee las mismas clases, variables y límites que esta página, guarda con las mismas revisiones y recibe la línea y el motivo si algo no está permitido. Los cambios se publican de inmediato, igual que en el panel. Consulta Conectar Claude. Pega esto para empezar:

text
Quiero cambiar el estilo de mis páginas de linkable.id con CSS personalizado.
Trabaja solo a través del conector de linkable.id:

1. Llama a get_theme_schema para kind "layout" y para kind "component", y lee
   sus secciones custom_css: las clases lk-*, las variables --lk-* y los
   límites. Usa solo esas clases y variables, nunca otros nombres de clase.
2. Lista mis temas de estructura y de widgets y pregúntame cuál cambiar. El CSS
   de estructura se aplica a toda la página; el de widgets solo a los widgets
   que usan ese tema, donde :scope es el propio widget.
3. Lee primero el custom_css actual del tema. set_theme_custom_css lo
   REEMPLAZA, así que envía siempre la hoja completa: conserva lo que hay salvo
   que te pida quitarlo, y nunca toques la región entre los comentarios
   "design-system tokens".
4. Para imágenes, usa url(vault:ID) con el id de una imagen de
   list_vault_assets; ninguna otra dirección. No uses @import, @font-face,
   !important ni anidar CSS con &.
5. Muéstrame el CSS y explícalo antes de guardar; después de guardar, dame el
   enlace de revisión de la respuesta. Si se rechaza, corrige la línea que
   indica e inténtalo de nuevo.

Lo que quiero: [describe el cambio]

Con cualquier otra IA. Un asistente sin el conector no puede ver tus temas, así que indícale la referencia para herramientas de IA, y luego pega tú su respuesta en el campo CSS personalizado del tema. Usa este prompt:

text
Escribe CSS para un [tema de estructura | tema de widgets] de linkable.id.
Reglas:
- Apunta solo a las clases y variables de la referencia de CSS de temas de
  linkable.id: https://help.linkable.id/reference/theme-css (cada clase, dónde
  está y las variables que la estilizan; mejor redefinir esas variables).
- El CSS de un tema de estructura se aplica a toda la página. El de un tema de
  widgets queda limitado a sus widgets automáticamente; usa :scope para el
  propio widget.
- Sin @import, @font-face, @charset, @namespace ni @page; sin image-set(),
  cross-fade(), image(), src() ni expression(); sin el carácter <, sin barras
  invertidas, sin anidar CSS con &, sin !important.
- url() solo como url(vault:ID) con un id que yo te dé, o una imagen o fuente
  data:.
- Reglas @ permitidas: @media, @supports, @keyframes, @container, @layer.
- Hasta 64 KB (tema de estructura) o 32 KB (tema de widgets).
Devuelve una sola hoja completa con un comentario corto sobre cada regla.

Lo que quiero: [describe el cambio]