` predefinito) e `class` aggiunge una classe a quell’involucro.
### settings
Le impostazioni della sezione. Ognuna ha bisogno di tre attributi: `type` (il tipo di campo), `id` (il nome con cui la leggi in Liquid) e `label` (l’etichetta nell’editor). `default` è facoltativo e riempie il campo quando la sezione viene aggiunta. I tipi disponibili sono nella pagina delle [impostazioni di input](https://shopify.dev/docs/storefronts/themes/architecture/settings/input-settings).
### blocks e max\_blocks
Ogni tipo di blocco ha un `type`, cioè il suo identificativo, e un `name` per l’editor. Le domande hanno due campi: `text` per la domanda e `richtext` per la risposta. Il valore predefinito di un `richtext` deve essere racchiuso in `
` o `
`, altrimenti Shopify dà errore.
Perché l’id della domanda è `heading` e non `domanda`? Perché l’editor, per dare un nome ai blocchi nella colonna di sinistra, cerca prima un campo con id `heading`, poi `title`, poi `text`. Così vedi l’elenco delle domande vere, invece di “Domanda, Domanda, Domanda”.
_La parte blocks dello schema: tipo, nome e i due campi di ogni domanda._
`max_blocks` limita il numero di blocchi. Il massimo di Shopify è 50 per sezione: io ne metto 20, perché una pagina con più domande diventa difficile da leggere. Questi blocchi vivono solo dentro la sezione: se ti servono componenti da riusare in più sezioni, nei temi recenti ci sono i [theme blocks](https://salvatorepitone.it/theme-blocks-shopify/).
### presets ed enabled\_on
`presets` è quello che rende la sezione disponibile in “Aggiungi sezione”. Senza preset, la sezione si può inserire solo scrivendo a mano nel template JSON. Il mio preset parte con tre domande di esempio, così il titolare vede subito come funziona.
`enabled_on` dice dove la sezione può essere aggiunta: qui home (`index`), pagine, prodotti e collezioni. Esiste anche il contrario, `disabled_on`, ma non puoi usarli tutti e due nella stessa sezione.
> **Attenzione:** lo schema deve essere JSON valido. Una virgola in più dopo l’ultimo elemento, una virgoletta dimenticata o un id ripetuto, e Shopify non salva il file. Se l’editor del codice ti dà un errore sullo schema, il problema è quasi sempre lì.
## Stile e accessibilità
Lo stile della sezione va nel tag `{% stylesheet %}`, tra il markup e lo schema. Shopify raccoglie il CSS di tutte le sezioni e lo carica una volta sola, anche se la sezione compare più volte nella pagina.
`sections/faq-semplice.liquid (parte 2: stile)`
```
{% stylesheet %}
.faq-semplice { max-width: 48rem; margin: 0 auto; padding: 2rem 1.5rem; }
.faq-semplice__voce { border-bottom: 1px solid currentColor; }
.faq-semplice__voce summary { cursor: pointer; padding: 1rem 0; font-weight: 600; }
.faq-semplice__voce summary:focus-visible { outline: 2px solid currentColor; outline-offset: 4px; }
.faq-semplice__risposta { padding-bottom: 1rem; }
{% endstylesheet %}
```
Due regole del tag, dalla [documentazione di stylesheet](https://shopify.dev/docs/api/liquid/tags/stylesheet): dentro non puoi usare Liquid, e ogni file può averne uno solo. Ho usato `currentColor` per bordi e contorno, così la sezione prende il colore del testo del tema, anche sugli sfondi scuri.
[Sull’accessibilità](https://salvatorepitone.it/accessibilita-ecommerce-shopify/), `` e `` fanno quasi tutto da soli: si aprono con il mouse, con il tasto Invio e con la barra spaziatrice, e i lettori di schermo annunciano se la risposta è aperta o chiusa. Non serve JavaScript. Ho aggiunto solo un contorno ben visibile quando la domanda riceve il focus da tastiera.
Il titolo è un ``, perché nella pagina l’`` c’è già. Domande chiare e spazi generosi non sono un dettaglio estetico: è quello che spiego parlando di [come il design del sito influisce sulle conversioni](https://salvatorepitone.it/ux-e-ui-perche-il-design-del-sito-web-influisce-sulle-conversioni/).
## Aggiungerla alla pagina dall’editor
Salva il file e torna ai temi. Sulla copia del tema clicca **Personalizza**, poi:
1. in alto scegli la pagina su cui lavorare (per esempio un prodotto, o una pagina come “Spedizioni e resi”);
2. nella colonna di sinistra clicca **Aggiungi sezione** e cerca “FAQ semplice”;
3. scrivi titolo, domande e risposte; trascina le domande per cambiarne l’ordine;
4. salva, controlla l’anteprima su computer e telefono, e pubblica la copia del tema quando sei convinto.
_Dal file nuovo alla sezione nell’editor, in quattro passi._
Ogni volta che aggiungi la sezione hai una copia indipendente, con i suoi contenuti: puoi avere FAQ diverse sulla pagina delle spedizioni e su un prodotto. Se le stesse domande devono comparire su molti prodotti, conviene un template prodotto dedicato con la sezione già dentro.
## Domande frequenti
### La sezione resta se aggiorno il tema?
Dipende da come aggiorni. Se il tema viene aggiornato dal Theme Store, Shopify crea una copia aggiornata e prova a riportare le tue modifiche, ma quelle incompatibili si perdono. Per stare tranquillo tieni una copia del file faq-semplice.liquid: se manca, lo ricrei in due minuti e i contenuti nei template JSON tornano al loro posto.
### Posso usare la stessa sezione in più pagine?
Sì. Il file è uno solo, ma ogni volta che aggiungi la sezione a un template ottieni un’istanza separata, con titolo e domande suoi. L’unico limite sono i template indicati in enabled\_on: nell’esempio home, pagine, prodotti e collezioni. Per aggiungerne altri basta inserirli nell’elenco dello schema.
### Perché non vedo la sezione nell’editor?
Le cause più comuni sono quattro: manca presets nello schema; il template su cui sei non è tra quelli di enabled\_on; lo schema non è JSON valido e il file non è stato salvato; stai guardando il tema pubblicato invece della copia su cui hai lavorato. Se il tema è vecchio, con template .liquid, la sezione si aggiunge solo nella home.
### Le FAQ della sezione hanno i dati strutturati?
No, la sezione stampa solo HTML. Potresti aggiungere a mano il JSON-LD di tipo FAQPage, ma oggi conviene poco: Google ha smesso di mostrare i risultati arricchiti delle FAQ nella ricerca a maggio 2026. Le FAQ restano utili perché rispondono ai dubbi dei clienti e il testo è leggibile da motori di ricerca e assistenti IA.
## Conclusione
Una sezione personalizzata è un file con tre parti: markup Liquid, stile e schema. Una volta capito lo schema, puoi costruire qualsiasi sezione: testimonianze, tabelle, loghi, confronti tra prodotti.
Se il tema ti sta stretto in più punti, una sezione alla volta può non bastare: è il lavoro che faccio nella [realizzazione e migrazione di negozi Shopify](https://salvatorepitone.it/realizzazione-e-migrazione-shopify/). Per piccole aggiunte e correzioni nel tempo c’è l’[assistenza e manutenzione del negozio online](https://salvatorepitone.it/assistenza-e-manutenzione-negozio-online/).
Ti serve una sezione su misura e non vuoi rischiare? [**Scrivimi**](https://salvatorepitone.it/contatti/): la preparo io, pronta da usare dall’editor. Ti rispondo io.