Senast uppdaterad: 20 november 2025
Innan du importerar data till HubSpot bör du läsa igenom följande begränsningar och krav. Du kan också öppna exempel på filer eller skapa exempel på filer för att komma igång.
Mer information om importverktyget finns i den här artikeln. När din fil är klar kan du läsa om hur du importerar den.
Tekniska krav och begränsningar
Alla filer som importeras till HubSpot måste:- Vara en .csv-, .xlsx- eller .xls-fil.
- Ha endast ett ark.
- Innehålla en rubrikrad där varje kolumnrubrik motsvarar en egenskap i HubSpot. Kolumnrubrikerna kan ordnas i valfri ordning utan att det påverkar importen. Du kan kontrollera om det redan finns en standardegenskap som matchar din rubrik eller skapa en anpassad egenskap innan du importerar. Läs mer om egenskapskrav.
- Innehålla färre än 1000 kolumner.
- Var UTF-8-kodad om den innehåller tecken från andra språk.
- Om du importerar en Excel-fil:
- Innehåller data som ligger under Excels maximala gränser för kalkylblad och arbetsböcker.
- Innehålla celler i talformat när du importerar egenskaper för datum- och tidsväljare.
Det finns ytterligare tekniska begränsningar för importverktyget beroende på ditt HubSpot-abonnemang. Dessa begränsningar inkluderar storleks- och radbegränsningar för en importfil, samt hur många filer och rader du kan importera per dag.
- Om du endast använder HubSpots kostnadsfria verktyg eller Smart CRM Professional eller Enterprise kan du:
- Importera filer på upp till 20 MB.
- Genomföra upp till 50 importer per dag.
- Importera upp till 500 000 rader per dag. Om du importerar en fil som innehåller mer än 500 000 rader kommer det att ta flera dagar att slutföra.
- Om ditt konto har ett Starter-, Professional- eller Enterprise- abonnemang kan du:
- Importera filer på upp till 512 MB.
- Genomföra upp till 500 importer per dag.
- Importera upp till 10 000 000 rader per dag, med en gräns på 1 048 576 rader per fil. Om du importerar via import-API:et kan du importera upp till 80 000 000 rader per dag.
Dessa gränser gäller för en rullande 24-timmarsperiod och återställs inte vid en viss tidpunkt på dygnet. Läs mer om ditt HubSpot-abonnemang och dess begränsningar.
Formatera värden
För varje rad i din importfil kan du lägga till värden för egenskapskolumnerna. Formateringen av ett värde beror på egenskapsfältets typ och målet med importen.
Formatera värden baserat på egenskapsfältstyp
Beroende på egenskapsfältets typ finns det specifika formateringskrav:
| Fälttyp | Krav |
| Datumväljare Datum- och tidsväljare |
Månader kan vara ett tal, tre bokstäver eller ett fullständigt namn (10, OKT, okt, OKTOBER, oktober), år kan vara två eller fyra siffror (2023, 23) och separatorer kan vara en snedstreck, bindestreck eller punkt (10/28/2023, 10-28-2023, 10.28.2023). Giltiga datumformat är dag månad år (t.ex. 28/10/2023), månad dag år (t.ex. 10-28-23) eller år månad dag (t.ex. 2023.OCT.28). Om du har ställt in valideringsregler måste dina importerade värden följa reglerna, annars importeras de inte. |
| Datum- och tidsväljare |
Tidsstämplar kan läggas till som hh:mm (28/10/2020 14:30) i alla filtyper eller som en UNIX-tidsstämpel i millisekunder i CSV-filer eller en Excel-fil med celler i textnummerformat. Om du inte anger en tidsstämpel ställs tiden in på midnatt som standard. |
| Varaktighet |
För egenskaper som innehåller en varaktighet, till exempel egenskapen Samtalets varaktighet, måste dina värden formateras som en UNIX-tidsstämpel i millisekunder. Läs mer om hur du formaterar tidsstämpelvärden och hur du konverterar ett datum till UNIX-format. |
| Uppräkning |
Värdena i din importfil måste matcha antingen etiketten eller det interna värdet för egenskapens definierade alternativ. För HubSPots standardegenskaper för uppräkning (t.ex. livscykelstadium, bransch) måste värdena matcha det interna värdet eller etiketten på engelska. |
| Fil |
Om du vill lägga till befintliga filer till en filegenskap anger du fil-ID som värde. Du hittar filens ID i avsnittet Allmänt i filens detaljer. |
| Flera kryssrutor |
För att importera flera värden lägger du till ett semikolon mellan varje värde utan mellanslag (värde 1;värde 2). Dessa egenskapsalternativ måste skapas före importen. För att lägga till eller lägga till värden, lägg till ett semikolon före det första värdet (;värde 3;värde 4). Detta lägger till värdet istället för att skriva över det befintliga egenskapsvärdet. Läs mer om att importera flera kryssrutevärden. |
| Nummer |
Formatera värdet baserat på typen av nummeregenskap som skapats:
|
| Enkel kryssruta |
Skapa en kolumn för fältet med en enda kryssruta och ställ in värdet på varje rad till True eller Yes för att visa Yes eller markerat i HubSpot, eller False eller No för att visa No eller omarkerat i HubSpot. |
| Termegenskaper |
Radobjektets egenskap Term ska läggas till i ISO-8601-periodformatet PnYnMnD eller PnW. Till exempel P12M eller P24M för årliga termer. Om fältet lämnas tomt kommer standardtermer att anges. |
| Text |
Om du har ställt in valideringsregler måste dina importerade värden följa reglerna, annars importeras de inte. |
| Användare (ägare) |
Så här tilldelar du en ägare till en post eller aktivitet under importen:
|
Ytterligare kontakt-e-postadresser eller företagsdomäner
Om du importerar kontakter med mer än en e-postadress, inkludera en kolumn med ytterligare e-postadresser med deras sekundära e-postadresser. Om du importerar företag med mer än ett domännamn, inkludera en kolumnmed ytterligare domäner med deras sekundära domäner. För att inkludera flera e-postadresser eller domäner i en cell, separera värdena med semikolon (t.ex. email@email.com; emailtwo@email.com).
Om du importerar för att skapa kontakter eller företag kan du inte ange en ny kontakts e-postadress eller ett nytt företags domännamn till en e-postadress eller domän som redan finns som ytterligare e-postadress/domän för en annan post.
Tomma celler
Importverktyget ignorerar tomma celler i ett kalkylblad, så när du importerar nya egenskapsdata ska du lämna cellerna tomma för poster utan värde för egenskapen. Om en befintlig post redan har ett värde för egenskapen i HubSpot kommer tomma celler inte att rensa det befintliga egenskapsvärdet. För att rensa befintliga egenskapsvärden i bulk kan du manuellt redigera värdena eller använda arbetsflödesåtgärden Redigera poster .Affärssamarbetspartners
Om du lägger till medarbetare till en affär via import ska du inkludera en rubrikför affärssamarbeten. För varje cell måste du inkludera två eller flera användare, åtskilda med semikolon (t.ex. user1@example.com;user2@example.com).Produktperiod och faktureringsfrekvens
Om du importerar ett värde för egenskapen Term kan du formatera värdet i kolumnen Term som ett tal i månader (t.ex. 10 för 10 månader), som PXM där X är antalet månader (t.ex. P6M för en löptid på 6 månader) eller PXY där X är antalet år (t.ex. P1Y för en löptid på 1 år).
Om du importerar ett egenskapsvärde för faktureringsfrekvens använder du månadsvis, årsvis eller kvartalsvis om produkten har en återkommande pris typ. Lämna cellen tom om produkten har ett engångspris.
Obligatoriska egenskaper
Beroende på vilka objekt eller aktiviteter du importerar krävs följande egenskaper för att skapa poster, och de måste inkluderas som kolumnrubriker i dina filer. Om du uppdaterar poster måste du inkludera en unik identifierare (t.ex. post-ID, e-postadress, företagets domännamn).
Det ärinte obligatoriskt,mendu kan importera ytterligare egenskaper för varje objekt, inklusive anpassade och standardegenskaper. Se standardegenskaperna för kontakter, företag, affärer, ärenden, samtal, e-postmeddelanden, möten, anteckningar och uppgifter. Du kan också visa alla egenskaper och deras värden i dina egenskapsinställningar.
- Kontakter: minst ett av förnamn, efternamn eller e-postadress.
- Företag: minst ett av Namn eller Företagsdomännamn.
Observera: egenskapen Företagsdomännamn accepterar endast värden upp till toppdomänen (t.ex. .com, .edu). Värden med strängar efter sig (t.ex. .edu/home) tas automatiskt bort när du importerar.
- Affärer: om du skapar nya affärer, affärens namn, pipeline och affärens stadium.
- Biljetter: om du skapar nya biljetter, biljettnamn, pipeline och biljettstatus.
- Möten: Mötesstart. Mötesstarten ska formateras som en datum- och tidegenskap.
- Kurser: Kursnamn.
- Listningar: Namn.
- Tjänster: namn, pipeline och pipeline-stadium.
- Produkter: om du uppdaterar produkter, post-ID eller SKU.
- Om du uppdaterar produkter i ett konto med en valuta, enhetspris och namn.
- Om du uppdaterar produkter i ett konto med flera valutor, pris [valutabeteckning] (t.ex. pris USD) och namn.
- Beställningar: Namn, pipeline och pipeline-stadium.
- Kundvagnar: Namn.
- Rader: Namn, kvantitet, pris och tillhörande affärers register-ID eller affärens namn. Inkludera produktens produkt-ID om du också kopplar raden till en produkt, som kommer att mappas som en radegenskap under importen.
Observera: när du importerar rader med affärer uppdateras inte affärens belopp under importen. För att uppdatera det associerade affärsbeloppet kan du manuellt redigera raderna eller associera raderna med en affär i HubSpot.
- Samtal: Samtalsanteckningar. När du importerar nya samtal rekommenderas det också att inkludera aktivitetsdatum.
- E-post: E-postens brödtext och e-postens riktning.
- Möten: Mötesbeskrivning, mötesstarttid och mötes sluttid. När du importerar nya möten rekommenderas det också att inkludera aktivitetsdatum. Starttid, sluttid och aktivitetsdatum ska formateras som datum- och tidegenskaper.
- Anteckningar: Anteckningens innehåll.
- Uppgifter: Uppgiftens titel och förfallodatum. Förfallodatumet bör formateras som en datum- och tidegenskap.
Observera: även om det inte är obligatoriskt rekommenderas det att inkludera aktivitetsdatum när du importerar nya aktiviteter för att ange datum och tidpunkt för när aktiviteten ägde rum. Om du inte inkluderar denna egenskap ställs aktivitetsdatumet automatiskt in på datum och tidpunkt för importen.
Krav för att uppdatera befintliga poster eller undvika dubbletter
För att uppdatera befintliga poster och undvika dubbletter måste dina filer innehålla en unik identifieringsegenskap för varje objekt. För alla objekt kan du exportera befintliga poster och använda post-ID som en unik identifierare, eller använda en anpassad egenskap som kräver unika värden. För kontakter kan du också använda e-postadress. För företag kan du också använda företagets domännamn.
Om du importerar flera objekt och inkluderar post-ID:n rekommenderas det att du differentierar filens kolumnrubriker så att ID:t matchar rätt objekt (t.ex. en kolumn som heter Post-ID – Kontakter och en annan som heter Post-ID – Företag).
Observera: följande gäller om e-postadress eller företagsdomännamn ingår i din fil:
- Om du använder en anpassad unik värdeegenskap för att deduplicera kontakter, kommer egenskapen E-post fortfarande att kräva unika värden.
- Om du använder en anpassad unik värdeegenskap för att deduplicera företag kräver egenskapen Företagsdomännamn inte unika värden. Det innebär att du kan importera dubbla företagsdomäner. Om du inte vill ha flera företag med samma domän bör du ta bort dubbla domäner från din fil innan du importerar, eller använda Företagsdomännamn som din unika identifierare istället.
- Du kan använda en sekundär e-postadress som unik identifierare för befintliga kontakter som har en sekundär e-postadress angiven i HubSpot. Om du använder en sekundär e-postadress och inte inkluderar kolumnen Record ID i din fil kommer den sekundära e-postadressen inte att ersätta den primära e-postadressen. Om du däremot inkluderar både den sekundära e-postadressen och Record ID som kolumner i din fil kommer den sekundära e-postadressen att ersätta den primära e-postadressen.
Krav för att koppla poster
Importera kopplingar i en fil
I en fil kan du koppla två eller flera poster per rad. Inkludera information om kopplade poster och/eller aktiviteter i samma rad och inkludera en unik identifierare för varje objekt. För att koppla en post till flera aktiviteter eller poster för ett annat objekt, inkludera postens unika identifierare i flera rader för varje post du vill koppla.
Luke Danes är till exempel chef på Luke's Diner, men entreprenör på The Dragonfly Inn. För att associera honom med båda företagen måste du inkludera två rader för Luke Danes med kolumnerna E-post (eller Post-ID) och Företagsdomännamn (eller Post-ID) för varje företag.
Observera: om du inte inkluderar unika identifierare (t.ex. E-post, Företagets domännamn, Post-ID) kommer importen att skapa dubbla poster istället för att koppla varje post till samma post.
Om du importerar samma objektsassociationer finns det ytterligare krav.
Importera kopplingar i två filer
För att associera poster för två objekt i två filer använder du en gemensam kolumn för att koppla samman posterna i varje fil. Du kan se exempel på filer för mer hjälp med att importera och associera poster.
Samma objektsassociationer
Du kan importera en fil för att koppla samman poster för samma objekt i bulk. Under importprocessen måste du markera en kryssruta för att inkludera samma objektkopplingar.
När du konfigurerar din fil ska du inkludera information om de associerade posterna i samma rad och inkludera en unik identifierare för varje post. Följande ytterligare krav gäller specifikt för import av samma objekt:
- Minst en post i ett postpar måste redan finnas i HubSpot innan importen. Du kan till exempel importera en ny kontakt och koppla den till en befintlig kontakt, men du kan inte importera för att skapa och koppla två nya kontakter.
- När du associerar befintliga kontakter/företag kan du endast använda den primärae-postadressen/företagsdomänen som unik identifierare. Sekundära e-postadresser eller domäner stöds inte.
- Om du kopplar flera poster till en post ska du separera posternas unika identifieringsvärden med semikolon i samma cell (t.ex. luke@lukesdiner.com; rory@yale.edu; sookie@dragonfly.com).
I exemplet nedan är Rory och Jackson nya kontakter som kopplas till unika etiketter för befintliga kontakter, med deras e-postadresser som unika identifierare. Sookie är en befintlig kontakt som kopplas till två befintliga kontakter med samma etikett. I den första raden är kopplingsetiketten en del av ett etikettpar, vilket innebär att när importen är klar kommer den kopplade posten att ha etiketten Förälder och Rory kommer att ha den parade etiketten Barn.
Förälder/barn-kopplingar
För att skapa barn-föräldraföretagsassociationer via import, läs mer om att importera barnföretag.
Anpassade associationsetiketter
Prenumeration krävs Ett Professional- eller Enterprise-abonnemang krävs för att kunna använda anpassade associeringsetiketter.
För att importera associeringsetiketter måste du inkludera en kolumn för associeringsetiketter . Denna kolumn ska endast läggas till om du vill lägga till etiketter för att beskriva associationer. Om du inte behöver märka associationer är kolumnen inte nödvändig.
- Du måste skapa associeringsetiketterna i HubSpot innan du importerar.
- För att ange en företagsassociation som primär, inkludera värdet Primär i kolumnen Associationsetikett för den raden.
- Om du vill ange flera etiketter för att beskriva relationen mellan två poster kan du inkludera flera associeringsetikettvärden i en cell, åtskilda med semikolon (t.ex. Chef; Faktureringskontakt).
- Om du importerar associeringsetiketter i en import med flera filer måste du inkludera kolumnen Associeringsetikett och en unik identifierare för objektet du associerar i samma fil.
- Om du importerar parade etiketter:
- För objektöverskridande associationer ska du endast inkludera en av etiketterna i kolumnen Association label. Etiketterna tilldelas rätt objekt under importprocessen.
- För associationer mellan samma objekt kommer posten ikolumnen " Associated [unique identifier]" att få den etikett som lagts till under importprocessen eller som finns med i filens etikettkolumn. Den andra posten i raden kommer att få den andra etiketten i paret.
Exempelfiler
I början av importprocessen kan du generera en exempelfil med de egenskaper som krävs för de valda objekten och aktiviteterna. Om du vill se fler exempel med ytterligare egenskaper, se den här artikeln med exempelfiler.
