Skip to content

Checkbox

Los Checkbox son herramientas interactivas que permiten a los usuarios elegir entre ninguna, una o varias opciones de una lista, según sus preferencias o necesidades. Cada casilla es independiente: marcar una no desmarca a las demás.


Te enviaremos promociones y beneficios exclusivos.
Se habilita al completar tus datos.

Probá hacer clic sobre la casilla o sobre el texto: ambos activan la selección.


El Checkbox permite tomar decisiones independientes y reversibles dentro de un formulario o una configuración. A diferencia de un Switch, la elección no se aplica en el momento: queda registrada y se confirma recién cuando el usuario envía el formulario o presiona la acción principal del flujo.


Text label
  1. Átomo de Checkbox: La casilla cuadrada de 20 × 20 px con radio pequeño. Es el único elemento que cambia de apariencia al seleccionarse (fondo primario + tilde blanco).
  2. TextGroup (Label): Texto principal que describe la opción. Es obligatorio y también funciona como área de clic.
  3. TextGroup → Description (booleano): Texto secundario en gris para aclarar o ampliar la opción. Se activa o desactiva según la necesidad.
  4. ActionIcon (booleano): Ícono accionable a la derecha, pensado para abrir información adicional (un tooltip, un modal o un detalle). Es independiente de la casilla: tocarlo no marca ni desmarca la opción.
  5. ErrorMessage (booleano): Mensaje de validación con ícono de alerta, alineado al texto. Solo aparece cuando el Checkbox entra en estado de error.

  • Default: Casilla blanca con borde gris. Invita a la acción sin competir con el contenido.
  • Hover: Al pasar el cursor por la casilla o por el texto, el borde toma el color primario y aparece un halo suave que confirma que el elemento es interactivo.
  • Focus: Al navegar con teclado se muestra un contorno azul alrededor de la casilla. Nunca debe ocultarse.
  • Active (presionado): La casilla se contrae levemente al presionarla, dando respuesta táctil inmediata.
  • Seleccionado (checked): Fondo primario con tilde blanco. Es el único estado que comunica una elección confirmada.
  • Indeterminado: Fondo primario con un guion. Se usa solo en un checkbox “padre” que controla una lista, cuando algunas opciones hijas están marcadas y otras no.
  • Error: El borde pasa a rojo y se enciende el ErrorMessage. Se usa cuando una casilla obligatoria no fue marcada al intentar avanzar.
  • Deshabilitado: Casilla y textos en gris claro, sin respuesta al cursor. El usuario puede leer la opción pero no modificarla.

  • Para ofrecer a los usuarios una variedad de opciones que puedan seleccionar en un formulario (filtros, preferencias, permisos).
  • Para permitir que los usuarios confirmen su aceptación de una política, servicio o conjunto de términos y condiciones.
  • Cuando la elección de una opción no depende de las demás y el usuario puede elegir varias al mismo tiempo, o ninguna.
  • Cuando la decisión se confirma recién al enviar el formulario.
  • Una sola opción entre varias mutuamente excluyentes: usá un Radio. Si solo puede haber una respuesta, el Checkbox genera confusión.
  • Activar o desactivar algo de forma inmediata (notificaciones, modo oscuro, biometría): usá un Switch, que aplica el cambio en el momento.
  • Disparar una acción (enviar, confirmar, eliminar): usá un Button. Marcar una casilla nunca debe ejecutar un proceso por sí solo.
  • Listas muy largas de opciones (más de 8 a 10): considerá un selector con búsqueda o un Multiselect para no saturar la pantalla.
  • Checkbox individual: cuando una (1) casilla entra en error, su ErrorMessage se activa debajo del texto.
  • Dentro de un Checkbox.Group: las casillas se marcan en rojo y el mensaje de error se muestra una sola vez, al final del grupo (booleano del grupo), no repetido en cada opción.
  • El error aparece al intentar avanzar, no mientras el usuario todavía está completando el formulario. Desaparece en cuanto la condición se cumple.

La Description y el ActionIcon son elementos opcionales que se encienden según la complejidad de la opción. Usá la Description para aclarar consecuencias o condiciones; usá el ActionIcon cuando la explicación sea demasiado extensa para una línea.

El texto secundario amplía la información de la opción.
Descripción y ActionIcon activos al mismo tiempo.

Es el mismo componente dentro de una caja. Toda la superficie de la tarjeta es accionable y tiene su propio estado de hover. Al seleccionarse, la tarjeta toma borde primario y un fondo suave, lo que refuerza la elección cuando las opciones tienen más peso visual.

Sin costo de mantenimiento.
Requiere validación de identidad.
Disponible próximamente.
  • Cuándo usarlo: para elegir productos, planes o servicios donde cada opción necesita más contexto o jerarquía visual.
  • Cuándo evitarlo: en formularios densos o listas de preferencias simples; ahí el Checkbox estándar es más liviano.
  • El ActionIcon se mantiene independiente también dentro de la tarjeta: tocarlo no altera la selección.

Checkbox preconfigurado para aceptar términos, políticas o condiciones del servicio. El texto se lee como una sola frase con el enlace integrado: “Acepto los Términos y condiciones”. Todos los campos se pueden personalizar (texto de aceptación, texto del enlace, texto posterior, destino y mensaje de error).

  • Una sola frase: el enlace forma parte de la oración. Así el usuario entiende qué está aceptando de un vistazo, y el lector de pantalla anuncia la casilla como “Acepto los Términos y condiciones”, no solo “Aceptar”.
  • Verbo en primera persona: “Acepto”, “Leí y acepto”. La casilla marcada representa lo que el usuario afirma.
  • El enlace abre el documento sin marcar la casilla; aceptar siempre es una acción explícita del usuario.
  • Obligatorio: si el usuario intenta avanzar sin aceptarlo, se muestra el mensaje “Debe aceptar Términos y Condiciones”.
  • Nunca lo muestres marcado por defecto: la aceptación debe ser una decisión consciente.
  • Textos largos: si la frase ocupa más de una línea, el texto continúa alineado a la derecha de la casilla, nunca debajo de ella.

Agrupa varios Checkbox bajo un Label y una Description comunes. En Figma es un componente detachable: una vez que lo detachás podés agregar las instancias que necesites.

Puede usarse agrupado de dos formas:

  • Vertical: no tiene límite de opciones. Es la opción recomendada por defecto porque facilita la lectura.
  • Horizontal: en mobile se pueden usar como máximo 2 opciones por fila y en desktop como máximo 4. Reservala para opciones con textos cortos.
Medios de contacto

Elegí por dónde querés recibir tus avisos.

Resúmenes y comprobantes.
Códigos y alertas de seguridad.
Novedades y recordatorios.
Movimientos en tiempo real.
Días de débito

Podés elegir más de un día.

Achicá la ventana para ver cómo el grupo horizontal pasa de 4 a 2 opciones por fila en mobile.

Tipo de cuenta

Seleccioná al menos una opción para continuar.

Medida Valor Uso
checkbox/gap 16 px Separación entre el encabezado del grupo (Label + Description) y las opciones.
checkbox/group-options (vertical) 8 px Separación entre opciones apiladas.
checkbox/group-options (horizontal) 16 px Separación entre opciones en fila.

  • Es un elemento semántico: se renderiza como una casilla de verificación nativa del navegador.
  • Soporta el estado deshabilitado nativo para evitar la interacción cuando sea necesario.
  • El label está asociado a la casilla, por lo que hacer clic en el texto también la activa y el lector de pantalla lo anuncia como su nombre.
  • El Checkbox.Group se anuncia como un grupo: el lector lee su Label antes de recorrer las opciones.
  • Mantiene el foco visible en la navegación por teclado.
  • Tab para navegar entre casillas y hacia el ActionIcon o el enlace de términos.
  • Espacio para activar o desactivar la casilla que tiene el foco.
  • Anuncia el rol automáticamente (“casilla de verificación”).
  • Informa el estado: marcada, no marcada o mixta (indeterminada).
  • El estado deshabilitado es leído por el lector de pantalla.
  • La Description y el ErrorMessage se leen junto con la casilla, de modo que la persona conoce el contexto y el error sin tener que buscarlos.
  • El ActionIcon siempre tiene un nombre accesible que explica qué información abre.

Consultá el historial de cambios de todos los componentes de este Design System en la Sheet de ChangeLog.