> 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. # Riferimento dei formati La tabella completa, estensione per estensione. Serve quando hai un file davanti e devi decidere in dieci secondi cosa farne. Tre parole ricorrono e vale la pena fissarle prima: * **Indicizzabile**: messo in una base di conoscenza diventa ricercabile e citabile. In una cartella normale nessun file viene indicizzato, qualunque sia il formato. * **Anteprima**: la scheda del file si apre dentro Userbot. Serve anche che del file esista ancora l'originale in archivio. * **Allegabile in chat**: lo puoi agganciare a un messaggio dal pulsante **+**. Ogni allegato finisce anche nella **Libreria**, nella cartella collegata alla chat oppure in File recenti. ## La tabella | Estensione | Indicizzabile | Anteprima | Allegabile in chat | Come viene letta | Se non funziona | | ------------------------------- | -------------------------- | ------------------------ | ------------------ | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | | `pdf` | Sì | Sì | Sì, fino a 10 MB | Il testo delle pagine, unito in un flusso. Nessun riconoscimento ottico | Stato **Vuoto**: è una scansione. Riesporta una versione con il testo | | `docx` | Sì | Sì | Sì, fino a 25 MB | Il testo del documento, senza impaginazione | Se è un `.doc`, riaprilo e salvalo in `.docx` | | `dotx` | Sì | Sì | Sì, fino a 25 MB | Come `docx` | Come `docx` | | `pptx` | Sì | Sì | Sì, fino a 25 MB | Solo il testo delle diapositive. Le note del relatore no | Sposta nelle diapositive ciò che sta nelle note | | `potx` | Sì | Sì | Sì, fino a 25 MB | Come `pptx` | Come `pptx` | | `xlsx` | Sì | Sì, prime 500 righe | Sì, fino a 25 MB | Foglio per foglio, valori calcolati e non formule, blocchi fino a 50 righe | Stato **Errore**: cerca la cella più lunga, una riga enorme blocca tutto il file | | `xls` | Sì | Sì, prime 500 righe | Sì, fino a 25 MB | Come `xlsx` | Come `xlsx` | | `csv` | Sì | Sì, prime 500 righe | Sì, fino a 25 MB | Blocchi di righe con l'intestazione ripetuta in ognuno | Come `xlsx` | | `md` | Sì | Sì | Sì, fino a 25 MB | Testo così com'è, titoli compresi | Il formato che rende meglio: se puoi scegliere, scegli questo | | `txt` | Sì | Sì | Sì, fino a 25 MB | Testo così com'è | Se è lungo e senza titoli, salvalo in `.md` e aggiungili | | `json` | Sì | Sì | Sì, fino a 25 MB | Testo così com'è | Se è molto grande, dividilo per sezioni | | `jira` | Sì | Sì, con stato e commenti | Sì, fino a 25 MB | Il testo dell'issue | Non lo prepari tu: nasce dalla [Conoscenza aziendale](/conoscenza-aziendale) | | `html` | Sì | Sì | Sì, fino a 25 MB | Testo e marcatori | Se ti serve solo il contenuto leggibile, salvalo in PDF | | `htm` | Sì | Sì | Sì, fino a 25 MB | Come `html` | Come `html` | | `log` | Sì | No | Sì, fino a 25 MB | Testo così com'è | Per rileggerlo devi scaricarlo | | `xml` | Sì | No | Sì, fino a 25 MB | Testo e marcatori | Per rileggerlo devi scaricarlo | | `yml` | Sì | No | Sì, fino a 25 MB | Testo così com'è | Per rileggerlo devi scaricarlo | | `yaml` | Sì | No | Sì, fino a 25 MB | Testo così com'è | Per rileggerlo devi scaricarlo | | `png` `jpg` `jpeg` `webp` `gif` | No: si conservano soltanto | Sì | Sì, fino a 10 MB | In chat l'AI le guarda e le descrive. Non entrano nelle ricerche | Se il dato deve essere ritrovabile, scrivilo anche in un documento | ## Le righe che sorprendono **`log`, `xml`, `yml`, `yaml` non hanno anteprima.** Si caricano, si indicizzano, l'AI ci trova dentro quello che serve, ma tu per rileggerli devi scaricarli. Se un file di testo lo consulti spesso, salvalo in `.md`: stesso contenuto, e la scheda si apre. **Ogni allegato in chat finisce nella Libreria.** Non resta nella conversazione: viene depositato fra i file, ed è da lì che l'AI lo apre. Se la chat è collegata a una cartella condivisa, il file lo vedono tutti quelli che accedono alla cartella. Tienilo presente con i documenti riservati. **Le immagini si caricano ma non si indicizzano.** Le trovi nella Libreria e le apri in anteprima, anche dentro una base di conoscenza, ma la ricerca nei documenti non le legge. **I file di codice non si caricano.** `.js`, `.py`, `.sql` e simili sono fuori dall'elenco accettato. Se il contenuto ti serve nelle ricerche, incollalo in un `.md`. ## Cosa non entra proprio `.doc`, `.ppt`, `.xlsm`, `.pps`, `.pages`, `.numbers`, `.key`, audio, video, archivi, `.svg`, `.dwg`, `.psd`. Compare un avviso con il nome del file, e quel file non viene caricato. Un `.ppt` si accetta soltanto come template. La strada è sempre la stessa: riaprire il file nel programma che l'ha creato ed esportarlo in uno dei formati della tabella. Un file protetto da password, invece, si carica se l'estensione è accettata, ma Userbot non riesce ad aprirlo: in una base di conoscenza finisce in **Errore**. > **Info** > > Un formato accettato non garantisce una risposta buona. Un PDF di 400 pagine > senza titoli e un manuale ben strutturato si indicizzano allo stesso modo, ma > il secondo si ritrova. → [Scrivere documenti che l'AI ritrova](/documenti-ricercabili)