# Instalar Qixoo en una web que ya existe

Añadir Qixoo lleva alrededor de un minuto y no cambia nada de cómo está construida tu
web ni de dónde está alojada.

## El fragmento

```html
<script src="https://qixoo.app/qixoo.js" data-key="TU_SITE_ID" defer></script>
```

Pégalo **una vez, antes de `</head>`, en cada página**. Después publica o vuelve a
desplegar la web como harías normalmente.

`TU_SITE_ID` es el Site ID que aparece en la tarjeta de tu sitio en el panel: pulsa el
icono de copiar que hay al lado.

## Paso a paso

1. Inicia sesión en `https://qixoo.app/dashboard/`. Enlace mágico por correo o Google,
   sin contraseña. Los correos nuevos obtienen cuenta automáticamente en el plan Free.
2. **Sites → + Add site** → pon un nombre y la URL del sitio.
3. En la tarjeta nueva abre **Connect → Install**.
4. Copia el fragmento y pégalo en tu HTML, o copia el **AI install prompt** y dáselo a
   tu asistente de código (Cursor, Claude, v0, Lovable): él insertará la etiqueta por
   ti.
5. Publica la web y pulsa **Open editor** en la tarjeta. Tu web publicada se abre con
   una capa de edición encima.

Para los visitantes no cambia nada hasta que hagas un cambio y lo guardes.

## Dónde pegarlo, según la plataforma

- **HTML escrito a mano** — en el `<head>` de cada página.
- **Un framework o generador de sitios estáticos** — en el layout o plantilla común,
  para que llegue a todas las páginas.
- **Constructores de webs** — casi todos tienen un ajuste «Custom code → head»; usa ese.
- **Webflow** — Site Settings → Custom Code → Head Code. Requiere un plan de sitio de
  pago de Webflow.
- **WordPress** — el `header.php` de la plantilla, o cualquier plugin de scripts en la
  cabecera.

## ¿El Site ID es un secreto?

No, y no es una contraseña. El Site ID solo identifica **de qué** sitio están hablando
el editor y la API pública de contenido. No puede iniciar sesión por nadie, no puede
cambiar tu contenido y no puede revelar nada que no esté ya público en tu página.
Editar exige tener la sesión iniciada en tu cuenta de Qixoo, y el editor usa un token
aparte de vida corta que nunca aparece en tu HTML. El Site ID que está en el código
fuente de tu página es tan inofensivo como la propia dirección de la página.

En la API de contenido para desarrolladores la cabecera HTTP se sigue llamando
literalmente `X-API-Key`: ese es el formato de transporte y lleva el mismo valor del
Site ID.

## Notas

- Las webs conectadas antes con el nombre de script antiguo `vibe-cms.js` siguen
  funcionando; no hay que hacer nada.
- El loader pesa unos 3 KB, no pone cookies, no rastrea y no envía datos de visitantes
  a nadie.
- Las single-page apps que rehacen el DOM después de cargar están soportadas en la
  medida de lo posible. Prueba una página antes de prometérselo a un cliente. El HTML
  renderizado en servidor y las exportaciones estáticas son el caso fiable.

Siguiente: [Edición](https://qixoo.app/es/docs/editing.md) ·
[Acceso de cliente](https://qixoo.app/es/docs/client-access.md)
