Senast uppdaterad: 3 oktober 2025
Innan du importerar data till HubSpot bör du granska följande begränsningar och krav. Du kan också få tillgång till exempelfiler eller generera exempelfiler för att komma igång.
Läs den här artikeln om du vill veta mer om importverktyget. Om din fil är klar kan du lära dig hur du importerar.
Tekniska krav och begränsningar
Alla filer som importeras till HubSpot måste:- Vara en .csv-, .xlsx- eller .xls-fil.
- Endast ha ett ark.
- Innehålla en rubrikrad där varje kolumnrubrik motsvarar en egenskap i HubSpot. Kolumnrubrikerna kan organiseras i valfri ordning utan att det påverkar importen. Du kan bekräfta 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 mindre än 1000 kolumner.
- Vara UTF-8-kodad om tecken på främmande språk ingår.
- Om du importerar en Excel-fil:
- Innehålla data som håller sig under Excels maxgränser för kalkylblad och arbetsbok.
- Innehåller celler i nummerformat vid import av egenskaper för datum- och tidsväljare.
Det finns ytterligare tekniska begränsningar för importverktyget beroende på din HubSpot-prenumeration. Dessa gränser inkluderar storlek och radgränser för en importfil, samt hur många filer och rader du kan importera per dag.
- Om du endast använder HubSpots kostnadsfria ellerSmart CRM Professional- eller Enterprise-verktyg kan du göra det:
- Importera filer på upp till 20 MB.
- Slutfö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 en Starter-, Professional- eller Enterprise-prenumeration kan du:
- Importera filer på upp till 512 MB.
- Slutfö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 API:et för import 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å dagen. Läs mer om din HubSpot-prenumeration och dess begränsningar.
Formatering av 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å typen av egenskapsfält och målet med importen.
Formatera värden baserat på egenskapsfälttyp
Beroende på typen av egenskapsfält finns det specifika formateringskrav:
| Fälttyp | Krav på formateringen |
| Väljare för datum Väljare för datum och tid |
Månader kan vara en siffra, tre bokstäver eller ett fullständigt namn (10, OCT, Oct, OCTOBER, October), år kan vara två eller fyra siffror (2023, 23) och separatorer kan vara ett snedstreck, bindestreck eller en 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 de importerade värdena följa reglerna, annars importeras de inte. |
| Väljare för datum och tid |
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 någon tidsstämpel är tiden inställd på midnatt som standard. |
| Varaktighet |
För egenskaper som innehåller en varaktighet, t.ex. egenskapen Call duration, 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 standarduppräkningsegenskaper (t.ex. Lifecycle stage, Industry) måste värdena matcha det interna värdet eller etiketten på engelska. |
| Filer |
Om du vill lägga till befintliga filer i en filegenskap anger du fil-ID:t som värde. Du hittar en fils ID i avsnittet Allmänt i filens detaljer. |
| Flera kryssrutor |
Om du vill 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. Om du vill lägga till eller bifoga värden lägger du till ett semikolon före det första värdet (;värde 3;värde 4). Detta gör att värdet läggs till istället för att skriva över det befintliga egenskapsvärdet. |
| Antal |
Formatera värdet baserat på den typ av nummeregenskap som skapats:
|
| Enstaka kryssruta |
Skapa en kolumn för fältet Single Checkbox och ställ in värdet på varje rad till True eller Yes för att visas som Yes eller markerad i HubSpot eller False eller No för att visas som No eller ej markerad i HubSpot. |
| Egenskaper för term |
Radobjektsegenskapen Term ska läggas till i ISO-8601 periodformat PnYnMnD eller PnW. Till exempel P12M eller P24M för årliga termer. Om den lämnas tom kommer standardvillkor att anges. |
| Text |
Om du har angett valideringsregler måste dina importerade värden följa reglerna, annars importeras de inte. |
| Användare (Ägare) |
För att tilldela en ägare till en post eller aktivitet under importen:
|
Ytterligare e-postadresser för kontaktpersoner eller företagsdomäner
Om du importerar kontakter med mer än en e-postadress ska du inkludera en kolumn Ytterligare e-postadresser med deras sekundära e-postadresser. Om du importerar företag med mer än ett domännamn ska du inkludera en kolumnYtterligare domäner med deras sekundära domäner. Om du vill inkludera flera e-postadresser eller domäner i en cell separerar du 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-post eller ett nytt företags företagsdomännamn till en e-post eller domän som är en befintlig ytterligare e-post/domän för en annan post.
Tomma celler
Importverktyget ignorerar tomma celler i ett kalkylblad, så när du importerar nya fastighetsdata ska du lämna celler tomma för poster utan ett värde för egenskapen. Om en befintlig post redan har ett värde för egenskapen i HubSpot, kommer tomma cellerinte attrensa det befintliga egenskapsvärdet.Om du vill rensa befintliga egenskapsvärden i bulk kan du redigera värdena manuellt eller använda arbetsflödesåtgärdenRedigera poster .Hantera medarbetare
Om du lägger till medarbetare till ett avtal via import ska du inkludera en rubrik föravtalsmedarbetare. För varje cell måste du inkludera två eller flera användare, åtskilda med semikolon (t.ex. user1@example.com;user2@example.com).Produktvillkor och faktureringsfrekvenser
Om du importerar ett Term-egenskapsvärde kan du formatera värdet i kolumnen Term som ett antal 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 termin på 6 månader) eller PXY där X är antalet år (t.ex. P1Y för en termin på 1 år).
Om du importerar ett egenskapsvärde för faktureringsfrekvens ska du använda månadsvis, årsvis eller kvartalsvis om produkten har en återkommande pristyp. 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 ingå som kolumnrubriker i dina filer. Om du uppdaterar poster måste du inkludera en unik identifierare (t.ex. post-ID, e-post, företagets domännamn).
Ävenomdet inte är obligatoriskt kan du importera ytterligare egenskaper för varje objekt, inklusive anpassade egenskaper och standardegenskaper. Se standardegenskaperna för kontakter, företag, erbjudanden, biljetter, 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 alternativen Förnamn, Efternamn eller E-post.
- Företag: minst ett av alternativen Namn eller Företagets domännamn.
Observera: egenskapen Företagets domännamn accepterar endast värden upp till toppdomänen (t.ex. .com, .edu). Värden med strängar efter (t.ex. .edu/home) tas automatiskt bort när du importerar.
- Deals: om du skapar nya deals, Deal name, Pipeline och Deal stage.
- Biljetter: om du skapar nya biljetter, biljettnamn, pipeline och biljettstatus.
- Möten: Start för möte. Mötesstarten bör formateras som en datum- och tidsegenskap.
- Kurser: Kursnamn: Kursens namn.
- Listningar: Namn: Namn.
- Tjänster: Namn: Namn, pipeline och pipeline-stadium.
- Produkter: om du uppdaterar produkter, post-ID eller SKU.
- Om du uppdaterar produkter på ett konto med en valuta, Enhetspris och Namn.
- Om du uppdaterar produkter på ett konto med flera valutor, Pris [Valutaförkortning] (t.ex. Pris USD ) och Namn.
- Beställningar: Namn, pipeline och pipeline-stadium.
- Kundvagnar: Namn.
- Varuposter: Namn, antal, pris och tillhörande avtals post-ID eller avtalsnamn. Inkludera produktens produkt-ID om du även associerar artikeln med en produkt, som kommer att mappas som en artikelegenskap under importen.
Observera: när du importerar rader med avtal uppdateras inte avtalsbeloppet vid importen. Om du vill uppdatera det associerade avtalsbeloppet kan du redigera raderna manuellt eller associera raderna med ett avtal i HubSpot.
- Samtal: Samtal: Anteckningar omsamtal. När du importerar nya samtal rekommenderas det också att inkludera aktivitetsdatum.
- E-postmeddelanden: E-postens brödtext och riktning.
- Möten: Mötesbeskrivning: Mötesbeskrivning, starttid för mötet och sluttid för mötet. När du importerar nya möten rekommenderas det också att inkludera aktivitetsdatum. Värdena för starttid, sluttid och aktivitetsdatum bör formateras som datum- och tidsegenskaper.
- Anteckningar: Anteckningens brödtext.
- Uppgifter: Uppgiftstitel och Förfallodatum . Förfallodatumet bör formateras som en datum-tid-egenskap.
Observera: även om det inte är obligatoriskt rekommenderas det att inkludera Aktivitetsdatum när du importerar nya aktiviteter för att ange datum och tid för när en aktivitet inträffade. Om du inte anger den här egenskapen ställs Activity date-värdena automatiskt in på datum och tid för importen.
Krav på att uppdatera befintliga poster eller undvika dubbletter
Om du vill uppdatera befintliga poster och undvika dubbletter måste dina filer innehålla en unik identifierare för varje objekt. För alla objekt kan du exportera befintliga poster och använda post-ID som enunik identifierare eller använda en anpassad egenskap som kräver unika värden. För kontakter kan du även använda Email. För företag kan du även använda Företagets domännamn.
Om du importerar flera objekt och inkluderar post-ID rekommenderas att du skiljer filkolumnrubrikerna åt för att matcha ID:t med rätt objekt (t.ex. en kolumn som heter Post-ID - Kontakter och en annan som heter Post-ID - Företag).
Observera: följande beteende gäller om e-post eller företagets domännamn ingår i filen:
- Om du använder en anpassad unik värdeegenskap för att avdubbla kontakter kommer e-postegenskapen fortfarande att kräva unika värden.
- Om du använder en anpassad unik värdeegenskap för att avdubbla företag kommer egenskapen Företagets domännamn inte att kräva unika värden. Detta 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 duplicerade domäner från filen innan du importerar, eller använda Företagets dom ännamn som unik 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 listad i HubSpot. Om du använder ett sekundärt e-postmeddelande och inte inkluderar kolumnen Record ID i din fil kommer det sekundära e-postmeddelandet inte att ersätta det primära e-postmeddelandet . Men om du 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 associera poster
Importera associationer i en fil
I en fil kan du associera två eller flera poster per rad. Inkludera information om associerade poster och/eller aktiviteter i samma rad och inkludera en unik identifierare för varje objekt. Om du vill associera en post med flera aktiviteter eller poster i ett annat objekt, inkluderar du postens unika identifierare i flera rader för varje post du vill associera.
Luke Danes är t.ex. chef på Luke's Diner, men entreprenör på Dragonfly Inn. Om du vill 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öretagets domä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 i stället för att associera dem till samma post.
Om du importerar samma objektassociationer finns det ytterligare krav.
Importera associationer i två filer
Om du vill associera poster för två objekt i två filer använder du en gemensam kolumn för att ansluta posterna i varje fil. Du kan se exempelfilerna för mer hjälp med att importera och associera poster.
Associationer för samma objekt
Du kan importera en fil för att associera poster för samma objekt i bulk. Under importprocessen måste du markera en kryssruta för att inkludera samma objektassociationer.
När du konfigurerar filen ska du inkludera information om de associerade posterna på samma rad och ange en unik identifierare för varje post. Följande ytterligare krav är specifika för import av samma objekt:
- Minst en post i ett postpar måste redan finnas i HubSpot innan du importerar. Du kan till exempel importera en ny kontakt och associera den med en befintlig kontakt, men du kan inte importera för att skapa och associera två nya kontakter.
- När du associerar befintliga kontakter/företag kan du bara använda den primärae-postadressen/företagsdomänen som din unika identifierare. Sekundära e-postmeddelanden eller domäner stöds inte.
- Om du associerar flera poster med en post ska du separera posternas unika identifieringsvärden med ett semikolon i samma cell (t.ex. luke@lukesdiner. com; rory@yale.edu; sookie@dragonfly.com).
I exempelfilen nedan är Rory och Jackson nya kontakter som associeras med unika etiketter till befintliga kontakter, där deras e-postvärden används som unika identifierare. Sookie är en befintlig kontakt som associeras med två befintliga kontakter med samma etikett. I den första raden är associationsetiketten en del av ett etikettpar, vilket innebär att när importen är klar kommer den associerade posten att ha etiketten Parent och Rory kommer att ha den parade etiketten Child.
Föräldra/barn-associationer
Om du vill skapa företagsassociationer mellan barn och förälder via import kan du läsa mer om att importera barnföretag.
Anpassade etiketter för associationer
Prenumeration krävs En Professional- eller Enterprise-prenumeration krävs för att använda anpassade associationsetiketter.
Om du vill importera associationsetiketter måste du inkludera en kolumn för Associationsetikett . Den här kolumnen ska bara läggas till om du vill lägga till etiketter för att beskriva associationer. Om du inte behöver etikettera associationer är kolumnen inte nödvändig.
- Du måste skapa associationsetiketterna i HubSpot innan du importerar dem.
- Om du vill ange att en företagsassociation ska vara primär anger du 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 associationsetikettvärden i en cell, åtskilda av ett semikolon (t.ex. Chef; Faktureringskontakt).
- Om du importerar associationsetiketter i en import av flera filer måste du inkludera kolumnen Associationsetikett och en unik identifierare för det objekt som du associerar i samma fil.
- Om du importerar parade etiketter:
- För associationer mellan objekt ska du bara inkludera en av etiketterna i kolumnen Associationsetikett. Etiketterna kommer att tilldelas rätt objekt under importprocessen.
- För samma objektassociationer kommer posten i kolumnen Associated [unique identifier] att få den etikett som lagts till under importprocessen eller som ingår i filens etikettkolumn. Den andra posten i raden får den andra etiketten i paret.
Exempel på filer
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 granska fler exempel med ytterligare egenskaper kan du läsa den här artikeln med exempelfiler.
