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
:scopepara 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
| Clase | Qué es |
|---|---|
lk-page | El <body> de la página; también lleva data-lk-layout-theme |
lk-layout--entry, lk-layout--site, lk-layout--fullscreen | El contenedor de la página, según el tipo de página |
lk-header, lk-header-inner, lk-header-logo | La barra superior, su fila de contenido centrada, el espacio del logo |
lk-header-link, lk-header-link-text, lk-header-link-icon | Un enlace de la barra superior, su texto, su ícono |
lk-header-drawer, lk-header-drawer-link, lk-header-icon | El panel del menú en el teléfono, sus enlaces, los íconos de menú y cerrar |
lk-submenu, lk-submenu-button | La barra bajo el encabezado en pantallas pequeñas, sus botones |
lk-content, lk-widgets | La columna de contenido, la pila de widgets dentro de ella |
lk-sidebar, lk-sidebar-title, lk-sidebar-entry (--active), lk-sidebar-category | El 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-title | Las 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-install | Una 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-title | La barra de encabezado de la tarjeta, su ícono, su título |
lk-widget-action--clipboard, --redirect, --download, --asset-download | Los botones de acción del encabezado (copiar, abrir, descargar) |
lk-widget-body, lk-widget-content, lk-widget-subtitle, lk-widget-brief | El 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-pdfes el visor completo;lk-pdf-toolbarla barra con el contador de páginas (lk-pdf-counter) y los botones (lk-pdf-button);lk-pdf-stageel área alrededor de las páginas;lk-pdf-pagecada página;lk-pdf-arrowlas flechas grandes de anterior y siguiente;lk-pdf-panellos paneles Páginas, Contenido y Buscar, conlk-pdf-thumb,lk-pdf-toc-itemylk-pdf-search-resultdentro.- Estados:
lk-pdf--fullscreenmientras el visor está en pantalla completa,lk-pdf-panel--openen el panel abierto,lk-pdf-thumb--currenten 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 ejemplo400ms; hasta3s) y--lk-pdf-shadow-strength(la luz y la sombra al pasar la página, de0, sin ellas, a1, 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:
.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:
: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:
: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:
.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 fuentedata:. 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@keyframesse 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:
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:
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]