Ultimo aggiornamento: 14 aprile 2026
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
Prima di importare i dati in HubSpot, verifica che i tuoi file rispettino il formato richiesto e i limiti tecnici. Alcuni limiti dipendono dal tipo di abbonamento. Informati su quali tipi di file sono supportati, su come strutturare e formattare i valori delle proprietà e su quanti record e file puoi importare in un determinato periodo.
Prima di procedere all'importazione, consulta l'articolo "Guida introduttiva alle importazioni".
Requisiti tecnici e limiti
Tutti i file importati in HubSpot devono:- Essere file .csv, .xlsx o .xls.
- Contenere un solo foglio.
- Includere una riga di intestazione in cui ogni intestazione di colonna corrisponda a una proprietà in HubSpot. Le intestazioni delle colonne possono essere organizzate in qualsiasi ordine senza influire sull'importazione. Puoi verificare se esiste già una proprietà predefinita corrispondente alla tua intestazione oppure creare una proprietà personalizzata prima dell'importazione. Scopri di più sui requisiti delle proprietà.
- Contenere meno di 1.000 colonne.
- Essere codificato in UTF-8 se il file include caratteri in lingua straniera.
- Se stai importando un file Excel:
- Contenere dati che rientrino nei limiti massimi del foglio di lavoro e della cartella di lavoro di Excel.
- Contenere celle in formato Numero quando si importano le proprietà del selettore di data e ora.
A seconda del tuo abbonamento HubSpot, allo strumento di importazione si applicano ulteriori limiti tecnici. Questi limiti includono le dimensioni e il numero massimo di righe di un file di importazione, nonché il numero di file e righe che puoi importare al giorno.
- Se utilizzi gli strumenti gratuiti di HubSpot, puoi:
- Importare file fino a 20 MB.
- Eseguire fino a 50 importazioni al giorno.
- Importare fino a 500.000 righe al giorno. I file contenenti più di 500.000 righe richiederanno diversi giorni per essere completati.
- Avviare fino a 3 importazioni contemporaneamente. Fino a 2 di queste importazioni possono superare le 10.000 righe. Se avvii 4 o più importazioni simultanee, queste verranno messe in coda.
- Se il tuo account dispone di Smart CRM o di un abbonamento Starter, Professional o Enterprise, puoi:
- Importare file fino a 512 MB.
- Completare fino a 500 importazioni al giorno.
- Importare fino a 10.000.000 di righe al giorno, con un limite di 1.048.576 righe per file. Se stai importando tramite l'API di importazione, puoi importare fino a 80.000.000 di righe al giorno.
- Avviare fino a 3 importazioni contemporaneamente. Fino a 2 di queste importazioni possono superare le 10.000 righe. Se si avviano 4 o più importazioni simultanee, queste verranno messe in coda.
Questi limiti si applicano a un periodo di 24 ore consecutive e non si azzerano a un'ora specifica del giorno. Scopri di più sul tuoabbonamento HubSpot e sulle sue limitazioni.
Formatta i valori delle proprietà
Per ogni riga del tuo file di importazione, puoi aggiungere valori per le colonne delle proprietà. La formattazione di un valore dipende dal tipo di campo della proprietà e dall'obiettivo dell'importazione.
Formattazione dei valori in base al tipo
della proprietà
A seconda del tipo di campo della proprietà, esistono requisiti di formattazione specifici:
| Tipo di campo | Requisiti |
| Selettore data Selettore di data e ora |
I mesi possono essere un numero, tre lettere o un nome completo (10, OCT, Oct, OCTOBER, October), gli anni possono essere a due o quattro cifre (2023, 23) e i separatori possono essere una barra, un trattino o un punto (10/28/2023, 10-28-2023, 10.28.2023). I formati di data validi sono giorno mese anno (ad es. 28/10/2023), mese giorno anno (ad es. 10-28-23) o anno mese giorno (ad es. 2023.OCT.28). Se sono state impostate regole di convalida, i valori importati devono seguire tali regole, altrimenti non verranno importati. |
| Selettore di data e ora |
I timestamp possono essere aggiunti come Gli offset di fuso orario relativi al fuso orario del tuo account possono essere aggiunti come |
| Durata |
Per le proprietà che contengono una durata, come la proprietà Durata della chiamata, i valori devono essere formattati come timestamp UNIX in millisecondi. Scopri di più su come formattare i valori dei timestamp e su come convertire una data nel formato UNIX. |
| Enumerazione |
I valori nel file di importazione devono corrispondere all'etichetta o al valore interno delle opzioni definite della proprietà. Per le proprietà di enumerazione predefinite di HubSpot (ad es. Fase del ciclo di vita, Settore), i valori devono corrispondere al valore interno o all'etichetta in inglese. |
| File |
Per aggiungere file esistenti a una proprietà file, includi l'ID file come valore. Puoi trovare l'ID di un file nella sezione Generale dei dettagli del file. |
| Caselle di controllo multiple |
Per importare più valori, aggiungi un punto e virgola tra ciascun valore senza spazi (valore 1;valore 2). Queste opzioni della proprietà devono essere create prima dell’importazione. Per aggiungere o appendere valori, aggiungere un punto e virgolaprima del primo valore (;valore 3;valore 4). In questo modo il valore verrà aggiunto invece di sovrascrivere il valore della proprietà esistente. Scopri di più sull'importazione di più valori delle caselle di controllo. |
| Numero |
Formatta il valore in base al tipo di proprietà numerica creata:
|
| Casella di controllo singola |
Crea una colonna per il campo casella di controllo singola e imposta il valore su ogni riga su TrueoYesper visualizzarlo come Yes o selezionato in HubSpot oppuresu FalseoNoper visualizzarlo come No o non selezionato in HubSpot. |
| Proprietà del termine |
La proprietà "Durata" della voce deve essere aggiunta nei formati di periodo ISO-8601 PnYnMnD o PnW. Ad esempio, P12M o P24M per le durate annuali. Se lasciata vuota, verranno impostate le durate predefinite. |
| Testo |
Se hai impostato regole di convalida, i valori importati devono seguire tali regole, altrimenti non verranno importati. |
| Utente (proprietario) |
Per assegnare un proprietario a un record o a un'attività durante l'importazione:
|
Indirizzi e-mail di contatto aggiuntivi o domini aziendali
Se stai importando contatti con più di un indirizzo e-mail, includi una colonna Indirizzi e-mail aggiuntivi con i loro indirizzi secondari. Se stai importando aziende con più di un nome di dominio, includi una colonnaDomini aggiuntivi con i loro domini secondari. Per includere più indirizzi e-mail o domini in una cella, separa i valori con punti e virgola (ad es., email@email.com; emailtwo@email.com).
Se stai importando per creare contatti o aziende, non puoi impostare l’indirizzo e-mail di un nuovo contatto o il nome di dominio aziendale di una nuova azienda su un indirizzo e-mail o un dominio che è già un indirizzo e-mail/dominio aggiuntivo esistente per un altro record.
Celle vuote
Lo strumento di importazione ignora le celle vuote in un foglio di calcolo, quindi quando importi nuovi dati relativi alle proprietà, lascia le celle vuote per i record privi di un valore per quella proprietà. Se un record esistente ha già un valore per quella proprietà all’interno di HubSpot, le celle vuote non cancelleranno il valore della proprietà esistente. Per cancellare in blocco i valori delle proprietà esistenti, puoi modificare manualmente i valori o utilizzare l’azionedel flusso di lavoro Modifica record .Collaboratori dell’opportunità
Se stai aggiungendo collaboratori a un’opportunità tramite importazione, includi un’ intestazioneCollaboratori dell’opportunità. Per ogni cella, devi includere due o più utenti, separati da punti e virgola (ad es., user1@example.com;user2@example.com).Durata del prodotto e frequenza di fatturazione
Se si importa un valore della proprietà Durata, è possibile formattare il valore nella colonna Durata come un numero in mesi (ad es. 10 per 10 mesi), come PXM dove X è il numero di mesi (ad es. P6M, per una durata di 6 mesi) o PXYdove X è il numero di anni (ad es. P1Y, per una durata di 1 anno).
Se si importa un valore della proprietà
"Frequenza di fatturazione ", utilizzare "mensile", "annuale" o " trimestrale " se il prodotto ha un tipo di prezzo ricorrente. Lasciare la cella vuota se il prodotto ha un prezzo una tantum.
Includere le proprietà obbligatorie
A seconda degli oggetti o delle attività che si stanno importando, le seguenti proprietà sono obbligatorie per creare record e devono essere incluse come intestazioni di colonna nei file. Se stai aggiornando i record, devi includere un identificatore univoco (ad es. ID record, e-mail, nome di dominio dell'azienda).
Sebbenenon sia obbligatorio, puoi importare proprietà aggiuntive per ciascun oggetto, incluse proprietà personalizzate e predefinite. Fai riferimento alle proprietà predefinite per contatti, aziende, trattative, ticket, chiamate, e-mail, riunioni, note e attività. Puoi anche visualizzare tutte le proprietà e i relativi valori nelle impostazioni delle proprietà.
- Contatti: almeno uno tra Nome, Cognome o Email.
- Aziende: almeno uno tra Nome o Nome di dominio dell'azienda.
Nota: la proprietà Nome di dominio dell'azienda accetta solo valori fino al dominio di primo livello (ad es. .com, .edu). I valori con stringhe successive (ad es. .edu/home) verranno automaticamente rimossi durante l'importazione.
- Offerte: se stai creando nuove offerte,Nome offerta, Pipeline e Fase dell'offerta.Pipeline eFase dell'offerta devono corrispondere alle opzioni esistenti nel tuo account e la Fase dell'offerta deve essere una fase valida in quella pipeline.
- Ticket: se stai creando nuovi ticket, Nome ticket, Pipeline e Stato del ticket.
- Appuntamenti: Inizio appuntamento. L'inizio dell'appuntamento deve essere formattato comeproprietà data-ora.
- Corsi: Nome del corso.
- Annunci: Nome.
- Servizi: Nome, Pipeline e Fase della pipeline.
- Prodotti: se stai aggiornando i prodotti, ID record o SKU.
- Se stai aggiornando prodotti in un account con una sola valuta,Prezzo unitario e Nome.
- Se stai aggiornando prodotti in un account con più valute,Prezzo [Abbreviazione della valuta] (ad es. Prezzo USD) e Nome.
- Ordini: Nome, Pipeline e Fase della pipeline.
- Carrelli: Nome.
- Voci d'ordine: Nome, Quantità, Prezzo e l'ID record o il nome dell'affare associato. Includi l'ID prodotto se stai associando la voce d'ordine anche a un prodotto; questo verrà mappato come proprietà della voce d'ordine durante l'importazione.
Nota: quando si importano voci di riga con offerte, l'importazione non aggiornerà l'importo dell'offerta. Per aggiornare l'importo dell'offerta associata, puoi modificare manualmente le voci di riga o associare le voci di riga a un'offerta in HubSpot.
- Chiamate: note sulle chiamate. Quando si importano nuove chiamate, si consiglia inoltre di includere Data dell'attività.
- Email: corpo dell'emaile destinatario dell'email.
- Riunioni:Descrizione della riunione, Ora di inizio della riunione e Ora di fine della riunione. Quando si importano nuove riunioni, si consiglia anche di includere la Data dell'attività. I valori relativi all'ora di inizio, all'ora di fine e alla data dell'attività devono essere formattati come proprietà data-ora.
- Note: corpo della nota.
- Attività:titolo dell'attivitàedata di scadenza. La data di scadenza deve essere formattata come proprietà data-ora.
Nota: sebbene non sia obbligatorio, si consiglia di includere la Data attività quando si importano nuove attività per specificare la data e l'ora in cui si è verificata un'attività. Se non si include questa proprietà, i valori della Data attività vengono automaticamente impostati sulla data e l'ora dell'importazione.
Requisiti per aggiornare i record esistenti o
evitare
duplicati
Per aggiornare i record esistenti ed evitare duplicati, i file devono includere una proprietà identificativa univoca per ciascun oggetto. Per tutti gli oggetti, è possibile esportare i record esistenti e utilizzare l'ID record come identificatore univoco, oppure utilizzare una proprietà personalizzata che richieda valori univoci. Per i contatti, è possibile utilizzare anche l'e-mail. Per le aziende, è possibile utilizzare anche il nome di dominio dell'azienda.
Se si importano più oggetti e si includono gli ID record, si consiglia di differenziare le intestazioni delle colonne del file in modo che l'ID corrisponda all'oggetto corretto (ad esempio, una colonna denominata ID record - Contatti e un'altra denominata ID record - Aziende).
Nota:se nel file sono inclusi Email o Nome dominio aziendale , si verificailseguente comportamento:
- Se si utilizza una proprietà con valore univoco personalizzata per deduplicare i contatti, la proprietà Email richiederà comunque valori univoci.
- Se utilizzi una proprietà con valore univoco personalizzata per deduplicare le aziende, la proprietà "Nome dominio azienda" non richiederà valori univoci. Ciò significa che puoi importare domini aziendali duplicati. Se non desideri più aziende con lo stesso dominio, dovresti rimuovere i domini duplicati dal tuo file prima dell’importazione, oppure utilizzare il "Nome dominio azienda" come identificatore univoco.
- Puoi utilizzare un'e-mail secondaria come identificatore univoco per i contatti esistenti che hanno un indirizzo e-mail secondario elencato in HubSpot. Se utilizzi un'e-mail secondaria e non includi la colonnaID record nel tuo file, l'e-mail secondaria non sostituirà l'e-mail primaria. Tuttavia, se includi sia l'e-mail secondaria che l'ID record come colonne nel tuo file, l'e-mail secondaria sostituirà l'e-mail primaria.
Requisiti per associare i record
Importare associazioni in un
unico
file
In un unico file, puoi associare due o più record per riga. Includi le informazioni sui record e/o sulle attività associate nella stessa riga e includi un identificatore univoco per ogni oggetto. Per associare un record a più attività o record di un altro oggetto, includi l'identificatore univoco del record in più righe per ogni record che desideri associare.
Ad esempio, Luke Danes è un manager presso Luke's Diner, ma un collaboratore esterno presso The Dragonfly Inn. Per associarlo a entrambe le aziende, è necessario includere due righe per Luke Danes con le colonne Email (o ID record) e Nome dominio azienda (o ID record) per ciascuna azienda.
Nota: se non si includono identificatori univoci (ad es. Email, Nome dominio azienda, ID record), l'importazione creerà record duplicati invece di associarli allo stesso record.
Se stai importando associazioni di oggetti identici, ci sono requisiti aggiuntivi.
Importa associazioni in due file
Per associare record di due oggetti in due file, usa una colonna comune per collegare i record in ciascun file. Puoi fare riferimento ai file di esempio per ulteriore assistenza nell'importazione e nell'associazione dei record.
Associazioni di oggetti identici
Puoi importare un file per associare in blocco
i
record dello stesso oggetto. Durante il processo di importazione, dovrai selezionare una casella di controllo per includere le associazioni di oggetti identici.
Quando configuri il tuo file, includi le informazioni sui record associati nella stessa riga e includi un identificatore univocoper ciascun record. I seguenti requisiti aggiuntivi sono specifici per le importazioni di oggetti identici:
- Almeno un record di una coppia di record deve già esistere in HubSpot prima dell'importazione. Ad esempio, puoi importare un nuovo contatto e associarlo a un contatto esistente, manonpuoi importare per creare e associare due nuovi contatti.
- Quando si associano contatti/aziende esistenti, è possibile utilizzare solo l'indirizzo e-mail principale oil dominio aziendale come identificatore univoco. Gli indirizzi e-mail o i domini secondari non sono supportati.
- Se si associano più record a un unico record, separare i valori degli identificatori univoci dei record con un punto e virgola nella stessa cella (ad es.luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com).
Nel file di esempio riportato di seguito, Rory e Jackson sono nuovi contatti associati a etichette univoche a contatti esistenti, utilizzando i loro valoridi e-mailcome identificatore univoco. Sookie è un contatto esistente associato a due contatti esistenti con la stessa etichetta. Nella prima riga, l'etichetta di associazione fa parte di una coppia di etichette, il che significa che una volta completata l'importazione, il record associato avrà l'etichettaGenitore e Roryavrà l'etichetta abbinata,Figlio.
Associazioni genitore/figlio
Per creare associazioni di società figlio-genitore tramite importazione, scopri di più sull'importazione di società figlie.
Etichette di associazione personalizzate
Abbonamento richiesto Per utilizzare le etichette di associazione personalizzate è necessario un abbonamento Professional o Enterprise.
Per importare le etichette di associazione, includi una colonna Etichetta di associazione. Questa colonna deve essere aggiunta solo se desideri aggiungere etichette per descrivere le associazioni. Se non hai bisogno di etichettare le associazioni, la colonna non è necessaria.
- È necessario creare le etichette di associazione in HubSpot prima dell'importazione.
- Per impostare un'associazione aziendale come primaria, includi il valore Primaria nella colonna Etichetta associazioneper quella riga.
- Per impostare più etichette che descrivono la relazione tra due record, puoi includere più valori di etichetta di associazione in una cella, separati da un punto e virgola (ad es., Responsabile; Contatto di fatturazione).
- Se stai importando etichette di associazione in un'importazione da più file, devi includere la colonna Etichetta di associazione e un identificatore univoco per l'oggetto che stai associando nello stesso file.
- Se stai importandoetichette accoppiate:
- Per le associazioni tra oggetti, includere solo una delle etichette nella colonna Etichetta di associazione. Le etichette verranno assegnate all'oggetto corretto durante il processo di importazione.
- Per le associazioni dello stesso oggetto, il record nellacolonna [identificatore univoco] associato riceverà l'etichetta aggiunta duranteil processo di importazione o inclusa nella colonna delle etichette del file. L'altro record nella riga riceverà l'altra etichetta della coppia.
File di esempio
All'inizio del processo di importazione, è possibile generare un file di esempio con le proprietà richieste per gli oggetti e le attività selezionati. Se desideri esaminare altri esempi con proprietà aggiuntive, consulta questo articolo con i file di esempio.
Passaggi successivi
Ora che il file di importazione è completo, segui le istruzioni di importazione appropriate:
