> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.userbot.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.userbot.ai/_mcp/server.

# Lavorare nel canvas

Quando un testo è lungo o lo rivedrai più volte, leggerlo dentro la
conversazione diventa scomodo: scorre via, e ogni modifica ne produce una copia
nuova più in basso.

Il **canvas** risolve questo. Il documento si apre in un pannello accanto alla
chat: resta lì mentre continui a parlare, e le modifiche lo aggiornano invece di
riscriverlo da capo.

## Aprirlo

Si apre da solo quando chiedi un documento di una certa lunghezza. Puoi anche
chiederlo: *«aprilo nel canvas così lo sistemiamo insieme»*. Per riaprirlo dopo
averlo chiuso:

#### Trova la scheda del documento nella risposta

È il riquadro con il titolo del documento, dentro il messaggio dell'AI.

#### Cliccala

Il canvas si apre a destra, accanto alla conversazione.

![Il clic sulla scheda del documento nella risposta e il canvas che si apre a destra, con il testo del documento, mentre la chat resta a sinistra](/_fern-files/userbot-035249.docs.buildwithfern.com/c1aa4b4b333c7098eee673a7e04bc33120401769494c5e60985a95606842dbae/docs/assets/animazioni/chat-canvas-apertura.gif)

![Il canvas aperto a destra della conversazione: il documento con il suo titolo e lo stato di salvataggio, e a sinistra la chat che resta utilizzabile per chiedere le modifiche](/_fern-img/18d50da47e61f82659f994ba970a1fa09c5a981999e6d4a6cd31c69905c9ff16.webp)

## Modificare

Hai due strade, e conviene alternarle.

**Chiedendolo nella chat**, per le modifiche che riguardano il senso o la
struttura: *«sposta la sezione sui costi prima di quella sui tempi»*,
*«rendi il tono più formale»*.

**Scrivendo direttamente nel documento**, per le correzioni puntuali: una
parola, un numero, una virgola. Più veloce che spiegarle.

Le modifiche che fai a mano restano. Quando poi chiedi un cambiamento nella chat,
Userbot lavora sulla versione che vedi, non su quella di partenza.

## La cronologia

Il canvas tiene traccia delle versioni. Dal comando **Cronologia** rivedi gli
stati precedenti e torni a quello che preferisci.

![Il pannello Cronologia aperto sopra il documento: ogni riga è una versione a cui tornare, e all'inizio ce n'è una sola, quella generata dall'AI, con l'ora](/_fern-img/21af95afd70865fa72e75b10cc31e9547c9d59bbc7aabdc9852fc151fc5c88be.webp)

È la rete di sicurezza che rende conveniente sperimentare: se una riscrittura
peggiora il testo, si torna indietro invece di ricostruirlo a memoria.

## Salvataggio

Il documento si salva da solo mentre lavori. Accanto al titolo vedi lo stato:
**Salvataggio…** mentre scrive, **Salvato ora** appena finito e poi **Salvato**,
oppure **Modifiche non salvate** se qualcosa non è ancora andato a buon fine.

Se chiudi la conversazione e la riapri, ritrovi il documento com'era.

## I comandi

| Comando              | Cosa fa                                                        |
| -------------------- | -------------------------------------------------------------- |
| **Schermo intero**   | Allarga il canvas su tutta la finestra, per leggere o rifinire |
| **Copia**            | Porta il contenuto negli appunti                               |
| **Scarica**          | Salva il file sul computer                                     |
| **Cronologia**       | Rivede e ripristina le versioni precedenti                     |
| **Chiudi documento** | Torna alla sola conversazione; il documento resta salvato      |

## Quando tu e l'AI modificate insieme

Il canvas è l'unico posto di Userbot in cui due mani lavorano sullo stesso testo.
Finché vi alternate non succede nulla di strano. Quando invece stai scrivendo e
nel frattempo arriva una modifica dalla chat, il canvas si ferma e ti chiede cosa
fare.

| Cosa leggi                                                                 | Cosa è successo                                                                   | Cosa scegliere                                                                          |
| -------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| *L'AI ha aggiornato il documento. Scartare le tue modifiche e ricaricare?* | Hai correzioni non ancora salvate e l'AI ha riscritto il documento                | **Annulla** se le tue modifiche contano: salvale prima, poi richiedi la modifica all'AI |
| *Hai modifiche non salvate. Sostituire con questa versione?*               | Stai ripristinando una versione dalla **Cronologia** mentre hai correzioni aperte | **Annulla** e attendi il **Salvato** accanto al titolo, poi ripristina                  |

In entrambi i casi confermare **sostituisce** quello che hai scritto a mano. Non
è una perdita definitiva (la **Cronologia** conserva gli stati precedenti), ma
ritrovare il pezzo giusto costa più che aspettare 2 secondi.

> **Note**
>
> La regola che evita del tutto il problema: quando chiedi una modifica in chat,
> **smetti di scrivere nel documento** finché non hai visto la risposta. Il
> salvataggio automatico impiega un attimo, e una correzione fatta mentre l'AI
> sta riscrivendo è quella che rischia di sparire.

## Non è il canvas delle Mini App

Il canvas dei documenti è un editor di testo: scrivi, l'AI riscrive, la
cronologia tiene traccia.

Il pannello con le due viste **codice** e **anteprima**, quello in cui vedi
subito come viene una pagina mentre la costruisci, è un'altra cosa: è il canvas
delle **Mini App**. Se quello che vuoi costruire non è un testo ma un piccolo
strumento con la sua interfaccia, è di là che si lavora.
→ [Cos'è una Mini App](/miniapp)

## Quando conviene e quando no

#### Conviene quando…

Il testo supera qualche paragrafo, o sai già che lo rivedrai. Il canvas ti
fa lavorare su un documento unico invece che su una catena di versioni sparse
nella conversazione.

#### Non serve quando…

Ti basta una risposta breve da copiare. Aprire un canvas per tre righe
aggiunge solo un pannello da chiudere.