` con gli attributi per l’editor; con `"tag": null` lo togli, ma allora l’elemento principale deve avere `{{ block.shopify_attributes }}`;
- con `"blocks": [{ "type": "@theme" }]` il blocco accetta altri blocchi al suo interno, e li stampa con `{% content_for 'blocks' %}`.
I blocchi il cui file inizia con un trattino basso, come `_slide.liquid`, sono “privati”: non compaiono tra i blocchi generici e si usano solo nelle sezioni che li nominano. Li uso per i pezzi che hanno senso in un solo contesto, come le slide di uno slideshow.
### Usarlo in una sezione con content\_for
La sezione dichiara nello schema quali blocchi accetta e li stampa nel punto giusto con `{% content_for 'blocks' %}`. Ecco una sezione “testimonianze”:
`sections/testimonianze.liquid`
```
{{ section.settings.titolo | escape }}
{% content_for 'blocks' %}
{% schema %}
{
"name": "Testimonianze",
"settings": [
{ "type": "text", "id": "titolo", "label": "Titolo", "default": "Dicono di noi" }
],
"blocks": [{ "type": "testimonianza" }, { "type": "@app" }],
"presets": [
{
"name": "Testimonianze",
"blocks": [
{ "type": "testimonianza", "settings": { "autore": "Nome cliente" } }
]
}
]
}
{% endschema %}
```
Qui la sezione accetta solo il blocco `testimonianza`, più gli app block: si chiama **targeting**. Con `{ "type": "@theme" }` accetterebbe tutti i theme blocks pubblici del tema. Io preferisco essere preciso: meno scelte, meno errori.
Un dettaglio che spiazza chi arriva dagli snippet: i blocchi non ricevono variabili dalla sezione. Leggono le proprie impostazioni (`block.settings`), la sezione che li contiene (`section`) e gli oggetti globali.
## Blocchi statici e preset
A volte un pezzo deve esserci sempre: il titolo di una riga a fisarmonica, l’icona di una scheda. Per questo esistono i **blocchi statici**, che la sezione stampa con `content_for 'block'` indicando tipo e id:
`sections/riga-fisarmonica.liquid`
```
{% content_for 'block', type: 'titolo-riga', id: 'titolo' %}
{% content_for 'blocks' %}
```
Un blocco statico si può configurare e nascondere dall’editor, ma non si può spostare, duplicare o eliminare. A differenza dei blocchi dinamici può stare dentro un `if` o un ciclo, e non conta nel limite `max_blocks`. L’`id` lo scegli tu e deve essere unico tra i blocchi dello stesso contenitore. I dettagli sono nella [documentazione del tag content\_for](https://shopify.dev/docs/api/liquid/tags/content_for).
I **preset** sono configurazioni pronte che il cliente sceglie dal menu “Aggiungi”: una sezione “Testimonianze” con tre blocchi già inseriti, una “Colonna” con titolo e testo. Ogni preset ha un `name` e può avere `category` per raggrupparlo, `settings` e `blocks`. Un blocco statico entra nel preset con lo stesso `id` usato nel Liquid e `"static": true`, per dargli valori iniziali diversi da quelli predefiniti.
I preset sono il modo migliore per insegnare il tema al cliente: invece di spiegargli come costruire una sezione da zero, gli do tre o quattro punti di partenza già belli.
## Limiti e buone abitudini
I limiti principali, dalla pagina dei [limiti dei temi](https://shopify.dev/docs/storefronts/themes/architecture/limits) (verificati a ottobre 2026):
- fino a **50 blocchi** per sezione (puoi abbassare il numero con `max_blocks`) e 1.250 per template;
- annidamento dei theme blocks fino a **8 livelli** sotto la sezione;
- al massimo **300 file** nella cartella `blocks`;
- `name` nello schema fino a 25 caratteri.
I blocchi aggiunti dal cliente, compresi gli app block, contano in questi limiti; i blocchi statici no. Le abitudini che mi evitano problemi:
- un blocco fa una cosa sola; per le combinazioni uso un blocco “gruppo” che ne contiene altri;
- annido al massimo due o tre livelli: oltre, l’editor diventa un labirinto per chi lo usa;
- ogni blocco ha il suo CSS nel tag `{% stylesheet %}`, così lo stile viaggia con il blocco;
- prima di consegnare uso l’editor come lo userebbe il cliente: aggiungo, sposto, cancello, e guardo cosa si rompe.
> **Un consiglio pratico:** scrivi le etichette dell’editor pensando a chi non ha mai visto il codice. “Allineamento del testo” si capisce, “text\_align\_desktop” no.
## Domande frequenti
### Che differenza c’è tra blocco di sezione e theme block?
Il blocco di sezione è definito nello schema di una sezione e vive solo lì. Il theme block è un file nella cartella blocks: lo puoi usare in più sezioni, annidare dentro altri blocchi e modificare in un punto solo. Una sezione può usare un tipo o l’altro, non tutti e due insieme; gli app block si affiancano a entrambi.
### I theme blocks funzionano con tutti i temi?
No. Servono un tema con la cartella blocks e sezioni che li accettino, con il tipo @theme o nominandoli uno per uno. I temi della famiglia Horizon sono costruiti così; molti temi Online Store 2.0 meno recenti usano solo i blocchi di sezione. I temi vintage non li supportano.
### Quanti blocchi posso mettere in una sezione?
Fino a 50 per sezione e 1.250 per template, contando anche gli app block aggiunti dal cliente (limiti verificati a ottobre 2026). Lo sviluppatore può fissare un numero più basso con max\_blocks. I blocchi statici, scritti direttamente nel codice della sezione, non contano in questi limiti.
### Il cliente può rompere il tema dall’editor?
Il codice no: dall’editor si cambiano impostazioni e contenuti, non i file. Può però peggiorare la grafica se il tema offre troppe opzioni libere. Per questo do scelte chiuse, schemi di colore e preset, e tengo fuori dall’editor ciò che deve restare coerente. Le modifiche, inoltre, si vedono in anteprima prima di salvarle.
## Conclusione
Un tema modificabile non nasce per caso: nasce da impostazioni scelte con criterio, blocchi piccoli e riutilizzabili, preset che guidano il cliente. È lo stesso principio della struttura delle cartelle che ho descritto in [creare un tema Shopify da zero](https://salvatorepitone.it/creare-tema-shopify-da-zero/): ordine all’inizio, libertà dopo.
Se vuoi un tema costruito così, trovi come lavoro nella pagina [realizzazione e migrazione Shopify](https://salvatorepitone.it/realizzazione-e-migrazione-shopify/).
Vuoi un tema che modifichi da solo senza paura di romperlo? [**Parliamone**](https://salvatorepitone.it/contatti/): ti rispondo io.