> For the complete documentation index, see [llms.txt](https://wonder-image.gitbook.io/wonder-image-gestionale/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wonder-image.gitbook.io/wonder-image-gestionale/user/catalogo/catalogo-immagini.md).

# Le foto degli articoli

> **Inclusa.** Fa parte del gestionale, non c'è niente da attivare.

## Si carica dove appartiene

Non si sceglie da un menu a chi appartiene una foto: **si carica nel posto giusto**, e il posto lo dice il riquadro.

Nella scheda del prodotto, sotto **Foto e video** (in cima alla colonna di destra), c'è un'area per ognuno:

* **Foto dell'articolo** — valgono per tutto. È il caso normale, e all'inizio c'è solo questa.
* **Foto blu**, **Foto rosso**… — un'area per ogni colore. Compaiono quando l'articolo ha più di un colore.

E c'è un terzo posto: la colonna **Foto o video** nella griglia delle *opzioni in vendita*. Quel file è di quella riga sola — "Blu / S" può avere il suo, diverso da "Blu / M".

In tutti e tre i posti si trascina il file dentro il riquadro.

## Quale foto vede il cliente

Tre livelli, dal più preciso al più generale:

1. le foto **dell'opzione in vendita**, se ne ha;
2. altrimenti quelle del **suo colore**;
3. altrimenti quelle **dell'articolo**.

Il primo livello che ha qualcosa **vince intero**: le foto non si mescolano, o una maglietta blu si ritroverebbe in mezzo lo scatto di quella rossa. Così basta caricare le foto di quello che cambia, senza rifare tutto il resto.

Chi sta guardando un colore — la sua pagina in vetrina — vede le foto di quel colore, non quelle della singola taglia.

## Foto e video insieme

Si accettano **png**, **jpg**, **webp** e **mp4**, un file per riga, fino a 8 MB l'uno. Un video si salva com'è: non ha misure da generare.

## Carica e salva: non aspetti

Il salvataggio è **immediato** anche con venti foto: il gestionale mette da parte l'originale e prepara dopo, per conto suo, tutte le misure che servono al sito (quelle per il telefono, per il computer, per la vetrina).

Per questo, appena salvi, accanto al file trovi scritto **pending**: è in coda. Nel giro di pochi minuti diventa **ready**. Nel frattempo la foto si vede lo stesso, solo un po' più pesante da scaricare.

Quello che c'è scritto lì è un resoconto, non una scelta: non si cambia a mano.

## La descrizione serve davvero

Il campo **Descrizione** è il testo che legge chi non può vedere l'immagine — e che leggono i motori di ricerca. "Maglietta blu girocollo, vista frontale" vale molto più di "foto1".

## L'ordine

L'ordine delle righe dentro un'area è quello in cui il cliente le vedrà: si trascinano.

## Se una foto resta indietro

**failed** vuol dire che il gestionale ci ha provato tre volte e ha smesso: quasi sempre è un file rotto, o un formato che non è quello che sembra.

Per rimediare: elimina la riga e ricarica il file, magari riesportandolo in JPG.

I tre tentativi servono a questo: una foto storta non deve bloccare tutte le altre.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wonder-image.gitbook.io/wonder-image-gestionale/user/catalogo/catalogo-immagini.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.