> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Collegare un dominio personalizzato

> Pubblica i link dei tuoi codici QR dal tuo sottodominio, ad esempio qr.yourbrand.com, invece che dal dominio breve condiviso di GetQR.

Collega un sottodominio di tua proprietà, ad esempio `qr.yourbrand.com`, in modo che i nuovi codici QR usino il tuo dominio invece del dominio breve condiviso di GetQR. Le persone vedono il tuo brand quando scansionano, e GetQR emette e rinnova per te il certificato HTTPS.

> [!NOTE]
>
> I domini personalizzati sono in versione beta e potrebbero non essere ancora disponibili in tutti i workspace. Se non vedi la scheda **Domains** nelle impostazioni dell'account, la funzione non è attiva per il tuo workspace.

## Prima di iniziare

* Ti serve il ruolo **Admin** o **Editor**. Un **Viewer** può vedere l'elenco dei domini ma non può modificare nulla.
* Ti serve l'accesso alle impostazioni DNS del tuo dominio, presso il tuo registrar o provider DNS (ad esempio Cloudflare, GoDaddy, Namecheap o Squarespace). Se il DNS è gestito da qualcun altro, durante la configurazione puoi scaricare i valori esatti da inviargli.
* Puoi collegare fino a 3 domini per workspace.
* Colleghi un **sottodominio**, non il dominio principale. `qr.yourbrand.com` funziona; `yourbrand.com` e `www.yourbrand.com` no. Il sito web e l'email sul dominio principale restano invariati.

## Collega il tuo dominio

**1. Apri la scheda Domains**

Nella barra laterale, apri il menu del profilo e fai clic su **My Account**. Poi seleziona la scheda **Domains**.

**2. Avvia la configurazione**

Fai clic su **Connect a domain**.

> [!TIP]
>
> Puoi anche iniziare dal generatore di codici QR: apri il menu a tendina dei domini nel campo **Custom short link** e fai clic su **Connect a domain**.

**3. Scegli un sottodominio**

In **Choose a subdomain**, scegli un prefisso: **qr**, **go**, **scan** o **link**. Per usare un prefisso tuo, fai clic su **Custom** e digitalo nel campo **Subdomain**.

**4. Inserisci il dominio principale**

In **Your domain**, digita solo il dominio principale, ad esempio `yourbrand.com`. GetQR verifica automaticamente il nome host completo e mostra **Checking availability…**.

**5. Verifica che il nome host sia disponibile**

Attendi il messaggio che conferma che il nome host è disponibile. L'anteprima sotto **Your codes will look like** mostra come appariranno i tuoi link. Fai clic su **Continue**.

**6. Copia il record DNS**

In **Add one DNS record**, copia i valori **Name** e **Target** con i pulsanti di copia. Il tipo di record è sempre **CNAME** e **Proxy** deve essere **DNS only — grey cloud**.

> [!TIP]
>
> Non gestisci tu il DNS? Fai clic su **Download instructions** per ottenere un file con i valori esatti per il tuo sviluppatore o team IT.

**7. Aggiungi il record CNAME presso il tuo provider DNS**

In una nuova scheda, apri il tuo provider DNS e aggiungi un record CNAME con i valori **Name** e **Target** che hai copiato. Imposta il TTL su Auto (predefinito). Consulta i [Consigli per provider](#consigli-per-provider) più sotto.

**8. Aggiungi il record CAA, se GetQR lo richiede**

Se la schermata di configurazione mostra un avviso CAA, il tuo dominio principale ha un record CAA che blocca l'autorità di certificazione di GetQR. Aggiungi il record aggiuntivo indicato nell'avviso, che ha questo aspetto:

```text theme={null}
yourbrand.com. CAA 0 issue "letsencrypt.org"
```

Se non c'è alcun avviso, salta questo passaggio.

**9. Comunica a GetQR che il record è stato aggiunto**

Torna su GetQR e fai clic su **I've added the record**. GetQR controlla subito il tuo DNS e passa alla schermata di verifica.

**10. Attendi la verifica**

GetQR esegue i controlli automaticamente e configura HTTPS. La verifica richiede in genere fino a 1 ora, a seconda del provider DNS e della regione. Puoi chiudere la finestra: GetQR continua a controllare e ti invia un'email quando il dominio è attivo.

Per controllare prima, fai clic su **Check now**.

**11. Testa il tuo dominio**

Quando il dominio è attivo, vedrai che è online tramite HTTPS. Apri il link di test (`your-subdomain/test`) per verificare che funzioni sul tuo dispositivo, poi fai clic su **Done**.

## Consigli per provider

Ogni provider usa etichette leggermente diverse, ma il record è sempre lo stesso: un record **CNAME** con i valori **Name** e **Target** mostrati in GetQR.

**Cloudflare**

1. Apri i record DNS del tuo dominio principale.
2. Aggiungi un record di tipo **CNAME**.
3. Incolla il **Name** (ad esempio `qr`) e il **Target** di GetQR.
4. Disattiva la nuvola arancione in modo che lo stato del proxy indichi **DNS only**.
5. Salva il record.

> [!WARNING]
>
> Cloudflare applica il proxy ai nuovi record per impostazione predefinita. Finché il record passa dal proxy (nuvola arancione), il certificato non può essere emesso e le scansioni non funzionano.

**GoDaddy**

1. Apri le impostazioni DNS del tuo dominio principale.
2. Aggiungi un nuovo record di tipo **CNAME**.
3. Inserisci il **Name** di GetQR nel campo del nome (host), ad esempio `qr`.
4. Incolla il **Target** di GetQR nel campo del valore (punta a).
5. Lascia il TTL sul valore predefinito e salva.

**Namecheap**

1. Apri le impostazioni DNS del tuo dominio principale.
2. Aggiungi un nuovo record di tipo **CNAME**.
3. Inserisci il **Name** di GetQR nel campo host, ad esempio `qr`.
4. Incolla il **Target** di GetQR nel campo del valore (target).
5. Lascia il TTL su Automatic e salva.

**Google / Squarespace**

I domini registrati con Google Domains sono ora gestiti da Squarespace.

1. Apri le impostazioni DNS del tuo dominio principale.
2. Aggiungi un record personalizzato di tipo **CNAME**.
3. Inserisci il **Name** di GetQR nel campo host, ad esempio `qr`.
4. Incolla il **Target** di GetQR nel campo dei dati (valore).
5. Salva il record.

> [!TIP]
>
> La maggior parte dei provider aggiunge automaticamente il dominio principale al nome. Inserisci solo la parte del sottodominio (`qr`), non `qr.yourbrand.com`, altrimenti potresti ritrovarti con `qr.yourbrand.com.yourbrand.com`.

## Usa il tuo dominio nei codici QR

Quando il dominio è attivo, lo scegli per ogni codice QR nel generatore. Nel campo **Custom short link**, apri il menu a tendina dei domini e seleziona il tuo dominio. I domini ancora in fase di configurazione compaiono nell'elenco con l'etichetta **Setting up** e non possono ancora essere selezionati. Consulta [Creare un link breve personalizzato](/it/short-links/create-short-link).

> [!WARNING]
>
> I codici QR mantengono il dominio con cui sono stati creati. I codici esistenti non passano al nuovo dominio e la rimozione di un dominio impedisce la scansione di tutti i codici QR che lo usano.

## Impostazioni

| Impostazione | Cosa fa |
| - | - |
| **Subdomain** | Il prefisso del nome host, ad esempio `qr`. Solo lettere, cifre e trattini. `www` non è consentito. |
| **Your domain** | Il tuo dominio principale, ad esempio `yourbrand.com`. Non includere qui un sottodominio. |
| **Type** | Sempre **CNAME**. |
| **Name** | L'etichetta del sottodominio da inserire presso il provider DNS. |
| **Target** | Il nome host GetQR a cui punta il record. È univoco per il tuo dominio, quindi copialo sempre dall'app. |
| **Proxy** | Deve essere **DNS only — grey cloud**. Un record con proxy blocca il certificato. |

## Casi d'uso

* **Fiducia nel brand.** Quando scansionano, le persone vedono `qr.yourbrand.com` nell'anteprima del link, non un dominio di terze parti.
* **Campagne.** Combina il tuo dominio con un link breve personalizzato, ad esempio `qr.yourbrand.com/summer-menu`.
* **Stampe di piccole dimensioni.** Un nome host breve genera un codice QR meno denso, che si scansiona in modo più affidabile anche in formato ridotto.

## Problemi comuni

> **Non vedo la scheda Domains**
>
> I domini personalizzati sono in versione beta e vengono attivati per singolo workspace. Se la scheda non compare nelle impostazioni dell'account, la funzione non è ancora disponibile per il tuo workspace.

> **Il pulsante Connect a domain è disattivato**
>
> Il tuo workspace ha già 3 domini, il massimo consentito. Rimuovine uno per collegarne un altro. Se non vedi affatto il pulsante, hai il ruolo **Viewer**; rivolgiti a un Admin o a un Editor.

> **“Use a subdomain such as qr.yourbrand.com”**
>
> Hai inserito un dominio principale. Un dominio principale richiede un record diverso e influirebbe sul tuo sito web e sull'email. Scegli un prefisso di sottodominio e inserisci solo il dominio principale in **Your domain**.

> **“www is reserved for your website”**
>
> `www` punta al tuo sito web, quindi GetQR non può usarlo. Scegli un altro prefisso, ad esempio `qr`.

> **“already includes a subdomain”**
>
> Hai digitato un sottodominio in **Your domain**, ad esempio `qr.yourbrand.com`. Inserisci solo il dominio principale (`yourbrand.com`) e scegli il prefisso in **Subdomain**.

> **“This domain is already connected to another GetQR account”**
>
> Un altro workspace GetQR usa già questo nome host. Scegli un sottodominio diverso oppure contatta [help@getqr.com](mailto:help@getqr.com) se ritieni che si tratti di un errore.

> **“That domain can't be connected”**
>
> Il nome host è riservato o non consentito. Scegli un sottodominio diverso.

> **La verifica richiede molto tempo**
>
> Le modifiche DNS possono richiedere un po' di tempo per propagarsi. Verifica che tipo, nome e target del record corrispondano esattamente a quelli dell'app e che il record non passi dal proxy. Consulta [Verificare il dominio](/it/custom-domains/verify-and-troubleshoot) per il significato di ogni stato.

## Passaggi successivi

> **[Verificare il dominio](/it/custom-domains/verify-and-troubleshoot)**
>
> Controlla lo stato e risolvi i problemi di DNS o di certificato.

> **[Creare un link breve personalizzato](/it/short-links/create-short-link)**
>
> Usa il tuo dominio e il tuo slug su un codice QR.

> **[Ruoli e permessi](/it/members/roles-and-permissions)**
>
> Scopri chi può collegare e rimuovere domini.

> **[Stampare il codice QR](/it/downloads/printing)**
>
> Stampa solo dopo che il tuo dominio è attivo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.