> For the complete documentation index, see [llms.txt](https://smartypilot.gitbook.io/smartypilot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smartypilot.gitbook.io/smartypilot/ricerca/filtri.md).

# Filtri e Varianti

La sezione **Filtri e Varianti** ti consente di configurare i filtri visualizzati nella sidebar dei risultati di ricerca e di gestire il raggruppamento delle varianti di prodotto. È suddivisa in tre parti: **Filtri predefiniti**, **Raggruppamento varianti** e **Filtri per attributi**.

<figure><img src="/files/698PFrJEN25wXhO01Jrn" alt=""><figcaption><p>Filtri predefiniti e raggruppamento delle varianti</p></figcaption></figure>

## Filtri predefiniti

In questa sezione puoi abilitare i filtri predefiniti già disponibili per i risultati di ricerca. Questi filtri sono progettati per coprire gli aspetti più comuni e rilevanti della ricerca, come brand, categoria e prezzo.

* **Mostra il filtro per brand**: Attivando questa opzione, gli utenti potranno filtrare i risultati in base al brand dei prodotti. Inserire un testo che identificherà il brand nei filtri di ricerca (es. marca, cantina, tipo, ecc.)
  * **Attributo brand alternativo** (opzionale): Se il brand dei tuoi prodotti non è memorizzato nel campo standard ma in un attributo personalizzato, sceglilo da questo menu a tendina, che elenca gli attributi rilevati nel tuo feed. Smartypilot userà quel campo al posto di quello predefinito per popolare il filtro brand.

{% hint style="warning" %}
Se modifichi il valore di questo campo, è necessario eseguire una **nuova sincronizzazione del feed** affinché le modifiche abbiano effetto sul catalogo.
{% endhint %}

* **Mostra il filtro per categoria**: Questa opzione consente di visualizzare un filtro che organizza i prodotti in base alle categorie del catalogo. Inserire un testo che identificherà la categoria nei filtri di ricerca (es. categorie, reparti, ecc.)
* **Mostra il filtro per prezzo**: Permette di abilitare un filtro per selezionare i prodotti in un determinato intervallo di prezzo.

### Come utilizzarli

* Attiva o disattiva i filtri che desideri visualizzare utilizzando i toggle accanto a ciascun filtro.
* Clicca su **Salva** per applicare le modifiche e aggiornare i filtri visibili nella sidebar dei risultati di ricerca.

## Raggruppamento varianti

Se il tuo catalogo contiene prodotti con combinazioni (ad esempio taglia + colore), questa sezione ti permette di scegliere come raggruppare i risultati di ricerca.

### Modalità raggruppamento

Puoi scegliere tra tre modalità tramite il menu a tendina **Modalità raggruppamento**:

* **Nessun raggruppamento**: ogni combinazione appare come un risultato separato nei risultati di ricerca. I badge delle combinazioni (colore, taglia, ecc.) vengono comunque mostrati su ciascun risultato.
* **Per prodotto padre**: mostra un solo risultato per ogni prodotto padre, raggruppando tutte le combinazioni disponibili (colori, taglie, ecc.) sotto un'unica card. Il prezzo mostrato è il prezzo minimo tra tutte le varianti del gruppo.
* **Per attributo**: raggruppa i risultati in base a uno o più attributi di combinazione che scegli tu. Dopo aver selezionato questa modalità, puoi indicare quali attributi usare come criterio di raggruppamento (es. solo colore, oppure colore e taglia insieme). Il prezzo mostrato è il prezzo minimo tra le varianti del gruppo.

### Attributi da escludere dai chip di variante

Nella stessa card trovi questo campo: gli attributi che selezioni qui **non vengono mostrati** fra i badge delle varianti nel box di ricerca. Serve a togliere di mezzo gli attributi tecnici o poco utili al cliente. Vale per qualsiasi modalità di raggruppamento, compresa "Nessun raggruppamento".

{% hint style="warning" %}
Ogni volta che modifichi le impostazioni di raggruppamento, devi eseguire una nuova **sincronizzazione del catalogo prodotti** affinché le modifiche abbiano effetto. L'avviso compare direttamente nel form al momento della modifica.
{% endhint %}

{% hint style="info" %}
Questa sezione è disponibile solo se nel catalogo sono presenti prodotti con combinazioni. Se non vedi le opzioni di raggruppamento, esegui prima una sincronizzazione del feed.
{% endhint %}

## Filtri per attributi

Questa sezione ti consente di configurare filtri personalizzati basati sugli attributi del prodotto presenti nel tuo catalogo. Puoi cercare, selezionare e configurare specifici attributi per renderli disponibili come filtri nei risultati di ricerca. Inoltre, puoi personalizzare l’**ordine** dei filtri per adattarli alle esigenze dei tuoi utenti.

* **Cerca attributo**: Usa il campo di ricerca per trovare rapidamente un attributo tra quelli disponibili nel catalogo.
* **Lista degli Attributi**:
  * **Usa come filtro**: Indica se l’attributo è attualmente attivo come filtro. Puoi attivarlo o disattivarlo utilizzando il toggle accanto a ciascun attributo.
  * **Usa nella ricerca:** Se attivo, il valore dell’attributo viene cercato anche nel testo digitato dal cliente. Di default gli attributi non vengono cercati. **Attenzione**: attivando **Usa come filtro**, questo toggle si accende da solo e non è più modificabile — un attributo usato come filtro entra sempre anche nella ricerca.
  * **Colore**: Se l’attributo rappresenta un colore (ad esempio "Colore", "Tinta", "Colorazione"), puoi attivare questo toggle per mostrare un quadratino colorato accanto a ogni valore nel filtro, rendendo più immediata la scelta da parte dell’utente. Il toggle è disponibile solo se **Usa come filtro** è attivo. Una volta abilitato, nella colonna **Azioni** compare il link **Gestisci →** per configurare i colori.
  * **SystemName**: Mostra il nome dell’attributo come definito nel sistema, questo valore non è modificabile.
  * **Nome Visualizzato**: Permette di personalizzare il nome del filtro che sarà visibile agli utenti (ad esempio, da "attr\_property" a "Proprietà").
  * **Azioni**: permette il salvataggio delle modifiche. Se il toggle **Colore** è attivo, mostra anche il numero di valori già mappati e il link **Gestisci →** per aprire la pagina di configurazione colori.
  * **Ordinamento dei Filtri**: Utilizza l’icona a forma di tre linee (≡) accanto a ciascun attributo per modificare l’ordine dei filtri nella ricerca. Trascina l’attributo verso l’alto o il basso per posizionarlo nella posizione desiderata rispetto agli altri filtri.
* **Solo Attivi**: è **acceso all'apertura della pagina**, quindi la lista mostra solo gli attributi già configurati come filtri. Per trovare un attributo che non hai ancora configurato devi **spegnerlo**.

### Come utilizzarla

1. Spegni **Solo Attivi** se l'attributo che cerchi non è ancora configurato come filtro.
2. Cerca un attributo utilizzando il campo **Cerca attributo**.
3. Attiva o disattiva l’attributo come filtro utilizzando il toggle.
4. Personalizza il **Nome Visualizzato** per renderlo più comprensibile agli utenti finali.
5. Modifica l’**ordine** dei filtri nella lista trascinando l’attributo con l’icona ≡ nella posizione desiderata.
6. Clicca su **Salva** per applicare le modifiche.

{% hint style="info" %}

### Abilita filtri rilevanti per aiutare gli utenti a raffinare la ricerca

Personalizza i filtri disponibili nella sidebar dei risultati per includere solo le categorie e gli attributi più rilevanti per i tuoi utenti. Ad esempio, se vendi abbigliamento, i filtri per brand, categoria, taglia e prezzo possono essere particolarmente utili.

**Tip**: Evita di sovraccaricare la sidebar con troppi filtri per non rendere l’esperienza troppo complessa; scegli solo quelli più utili per i tuoi utenti.
{% endhint %}

## Mapping colori

Quando attivi il toggle **Colore** su un attributo, puoi aprire la pagina di mapping cliccando su **Gestisci →** nella colonna Azioni. Qui trovi tutti i valori distinti di quell’attributo presenti nel tuo catalogo e puoi associare a ciascuno un colore da mostrare nel filtro.

<figure><img src="/files/0FKG9idWVL3RdznRGUqk" alt=""><figcaption><p>Il mapping dei colori per un attributo</p></figcaption></figure>

### Come funziona

Per ogni riga della tabella puoi:

* **Scegliere un colore singolo**: clicca sul quadratino colorato per aprire il selettore e scegliere il colore corrispondente al valore (es. "Rosso" → rosso vivo).
* **Scegliere più colori** per valori composti (es. "Nero e bianco", "Blu/Verde"): clicca il pulsante **+** per aggiungere un altro colore, fino a un massimo di **quattro** per valore. Raggiunto il quarto, il pulsante **+** scompare. Il widget mostrerà una sfumatura tra i colori scelti; clicca **×** per rimuovere un colore aggiunto (non puoi rimuovere l’ultimo rimasto).
* **Arcobaleno generico**: attiva il toggle nella colonna **Arcobaleno** per i valori indeterminati come "Assortito" o "Multicolore", dove i colori specifici non sono definibili. Il widget mostrerà una sfumatura multicolore.
* **Lasciare senza colore**: se un valore non è un colore (es. "Effetto cristallo", "Trasparente"), puoi lasciarlo senza mappatura. Il filtro mostrerà solo il testo, senza quadratino.

### Suggerimento automatico con AI

Per non dover inserire manualmente i colori uno per uno, puoi usare il pulsante **Suggerisci con AI** in cima alla pagina: Smartypilot analizzerà tutti i valori e proporrà automaticamente i codici colore più appropriati, incluse le sfumature per i valori composti e l’arcobaleno per quelli assortiti.

I suggerimenti vengono applicati alla pagina ma **non salvati** finché non clicchi **Salva tutto**: puoi rivedere e correggere ogni colore prima di confermare.

Se vuoi aggiornare il suggerimento per un singolo valore senza rielaborare tutto l’elenco, clicca l’icona ✦ nella riga corrispondente.

{% hint style="warning" %}
I suggerimenti AI sono una proposta di partenza. Verifica sempre i colori ottenuti, in particolare per valori specifici del tuo catalogo come finiture di legno, colori di brand o nomi creativi, e correggili con il selettore dove necessario.
{% endhint %}

### Come configurare i colori passo per passo

1. Nella tabella **Filtri da Attributi**, individua l’attributo colore e attiva il toggle **Colore**.
2. Clicca **Salva** sulla riga per confermare.
3. Clicca su **Gestisci →** nella colonna Azioni per aprire la pagina di mapping.
4. Clicca **Suggerisci con AI** per ottenere una proposta automatica per tutti i valori.
5. Controlla i risultati: correggi o completa i colori che ritieni imprecisi usando il selettore colore.
6. Clicca **Salva tutto** per confermare le modifiche.

I quadratini colorati saranno visibili immediatamente nel widget di ricerca per i tuoi clienti.