---
title: "Marca"
description: "Personaliza la apariencia de Hosted Auth con colores, fuentes, radio, logos y CSS personalizado."
locale: "es"
---

> Documentation Index
> Fetch the locale documentation index at: https://xid.dev/es/llms.txt
> Use this file to discover all available pages before exploring further.

# Marca

## Opciones de marca

La configuración de marca controla la apariencia visual de las páginas de Hosted Auth, la pantalla de consentimiento y las plantillas de correo. Cada organización puede anular los valores predeterminados a nivel de instancia.

| Opción | Descripción |
| --- | --- |
| Color principal | Color de acción principal usado para botones, enlaces y anillos de enfoque. Acepta valores CSS en hex u oklch. |
| Color de fondo | Fondo de página para las pantallas de Hosted Auth. |
| Color de acento | Color de resaltado secundario usado para etiquetas y elementos decorativos. |
| Radio de borde | Radio de esquina aplicado a tarjetas, entradas y botones. Elige entre ninguno, pequeño, mediano, grande o completo. |
| Familia tipográfica | Nombre de Google Fonts o una URL de fuente CDN personalizada. Usa la pila sans-serif del sistema como alternativa. |
| Logo (claro) | PNG o SVG mostrado en páginas de tema claro. Almacenado en R2. |
| Logo (oscuro) | PNG o SVG mostrado en páginas de tema oscuro. Usa el logo claro como alternativa cuando no se define. |

## Marca por organización

Cada organización puede anular la marca a nivel de instancia con su propio logo, colores y fondo. El Login Worker resuelve la configuración de marca por organización, usando los valores predeterminados de la instancia cuando no hay anulación de organización. Las lecturas del caché de marca se completan en menos de 2 ms en P50.

## Endpoint de la API de administración

Actualiza la marca de la organización con una solicitud PATCH. Solo se cambian los campos presentes en el cuerpo de la solicitud. Pasa `null` para limpiar un campo y restaurar el valor predeterminado del padre.

```shell
curl -X PATCH https://xid.dev/v1/organizations/org_xxx/branding \
  -H 'Authorization: Bearer sk_live_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
"primary_color": "#6366f1",
"border_radius": "medium",
"font_family": "Inter",
"hide_xid_branding": true
  }'
```

## Restricciones de CSS personalizado

- El tamaño máximo es 50 KB por organización.
- El filtro CSP elimina las reglas `@import` y las referencias `url()` que apuntan fuera de la lista permitida. Solo sobreviven las declaraciones puras de propiedades CSS.
- La ejecución de scripts externos desde CSS personalizado está bloqueada. Usa el CSS personalizado solo para anulaciones visuales, no para lógica de comportamiento.
- Los cambios se previsualizan en un sandbox iframe antes de publicarse. Los estados de previsualización y producción se mantienen separados.

## Marca en plantillas de correo

Las plantillas de correo transaccional (verificación, enlace mágico, OTP, restablecimiento de contraseña e invitaciones) toman automáticamente el logo y el color principal de la organización. Se pueden cargar plantillas HTML de correo personalizadas por organización a través de la consola.

Source: https://xid.dev/es/branding/index.mdx