Konfigurera filer för import
Senast uppdaterad: 3 juni 2025
Tillgänglig med något av följande abonnemang, om inte annat anges:
|
Innan du importerar data till HubSpot ska 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.
Om du vill veta mer om verktyget Import kan du läsa den här artikeln. 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
- Har endast ett ark.
- Innehålla en rubrikrad där varje kolumnrubrik motsvarar en egenskap i HubSpot. Kolumnrubrikerna kan organiseras i valfri ordning utan att importen påverkas. Du kan bekräfta om det redan finns en standardegenskap som matchar din rubrik eller skapa en anpassad egenskap före importen. Läs mer om krav på egenskaper.
- Innehåller mindre än 1000 kolumner.
- Vara UTF-8-kodad om tecken från 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 när du importerar egenskaper för datum- och tidsväljare.
Det finns ytterligare tekniska begränsningar för importverktyget beroende på din HubSpot Prenumeration. Dessa begränsningar inkluderar storlek och radgränser för en importfil, samt hur många filer och rader du kan importera per dag.
- Om du bara använder HubSpots gratis eller Smart CRM Professional eller Enterprise-verktyg kan du göra det:
- Importera filer 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 göra det:
- 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 fil för import kan du lägga till värden för kolumnerna med egenskaper. Formateringen av ett värde beror på egenskapsfältets typ och målet med importen.
Formatera värden baserat på egenskapens fälttyp
Beroende på typ av fält för egenskapen finns det specifika formateringskrav:
Typ av fält | Krav på fält |
Väljare för datum Väljare för datum och tid |
Månader kan bestå av en siffra, tre bokstäver eller ett fullständigt namn (10, OCT, Oct, OCTOBER, October), år kan bestå av två eller fyra siffror (2023, 23) och separatorer kan bestå av 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 de importerade värdena följa reglerna, annars kommer de inte att importeras. |
Väljare för datum och tid |
Tidsstämplar kan läggas till som hh:mm (28/10/2020 14:30) i alla typer av filer eller som en UNIX-tidsstämpel i millisekunder i CSV-filer eller en Excel-fil med celler i textnummerformat. Om du inte inkluderar någon tidsstämpel ställs tiden in på midnatt som standard. |
Varaktighet |
För egenskaper som innehåller en varaktighet, t.ex. egenskapen Samtalets var aktighet, måste värdena 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 import fil måste matcha antingen etiketten eller det interna värdet av egenskapens definierade alternativ. För HubSpots standardiserade uppräkningsegenskaper (t.ex. Livscykelfas, Egenskap) måste värdena matcha det interna värdet eller etiketten på engelska. |
Filer |
Om du vill lägga till befintliga filer i en egenskap för en fil anger du fil-ID 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 alternativ för egenskaper 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 kommer att lägga till värdet istället för att skriva över den befintliga egenskapens värde. |
Antal |
Formatera värdet baserat på den typ av egenskap för tal som skapats:
|
Enstaka kryssruta |
Skapa en kolumn för fältet med en kryssruta 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 inte markerad i HubSpot. |
Egenskap för term |
Radobjektets egenskap 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 ställt in valideringsregler måste dina importerade värden följa reglerna, annars kommer de inte att importeras. |
Användare (Ägare) |
För att tilldela en ägare till ett register eller en aktivitet under importen:
|
Ytterligare e-postmeddelanden för kontakter eller domäner för företag
Om du importerar kontakter med mer än en e-postadress, inkludera en kolumn Ytterligare e-postadresser med deras sekundära e-post. Om du importerar företag med mer än ett domännamn inkluderar du 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; [email protected]).
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 ett annat register.
Tomma celler
Importverktyget ignorerar tomma celler i ett kalkylblad, så när du importerar nya data om Egenskap, lämna cellerna tomma för register utan ett värde för egenskapen. Om ett befintligt register redan har ett värde för egenskapen i HubSpot, kommer tomma celler att inte rensa det befintliga värdet för egenskapen. Om du vill rensa befintliga värden för egenskaper i bulk kan du redigera värdena manuellt eller använd Arbetsflödesåtgärd föratt rensa värdet på egenskapen .Affärer med samarbetspartners
Om du lägger till medarbetare i en affär via import ska du inkludera en Affärer med medarbetare rubrik. För varje cell måste du ange två eller flera användare, åtskilda med semikolon (t.ex. [email protected];[email protected]).Produkternas löptid och faktureringsfrekvenser
Om du importerar en Term egenskap 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 term på 6 månader) eller PXY där X är antalet år (t.ex. P1Y, för en term 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.
Egenskaper som krävs
Beroende på vilka objekt eller aktiviteter du importerar krävs följande egenskaper för att skapa register och måste inkluderas som kolumnrubriker i dina filer. Om du uppdaterar register måste du inkludera en unik identifierare (t.ex. Register-ID, E-post, Företagets domännamn).
Ävenom det inte krävs kan du importera ytterligare egenskaper för varje objekt, inklusive anpassade objekt och standardegenskaper. Ringer standardegenskaperna för kontakter, företag, affärer, ärenden, samtal, E-post, möten, anteckningar och uppgifter. Du kan också visa alla egenskaper och deras värden i dina inställningar för egenskaper.
- Kontakter: minst ett av följande: Förnamn, Efternamn eller E-post.
- Företag: minst ett av följande : Namn eller Företagets domännamn.
- Affärer: om du skapar nya affärer, Affärsnamn, Pipeline och Affärsfas.
- Biljetter: om du skapar nya biljetter, Biljettnamn, Ärendepipeline och Biljettstatus.
- Utnämningar: Start för möte. Mötesstarten bör formateras som en egenskap för datum och tid.
- Kurser: Kursnamn: Kursens namn.
- Listningar: Namn: Namn.
- Tjänster: Namn: Namn, Pipeline och Pipeline-stadium.
- Produkter : om du skapar produkter, Enhetspris och Namn.
- Beställningar: Namn, Pipeline och Pipeline-stadium.
- Vagnar: Namn.
- Radobjekt: Namn, antal, pris och de associerade affärernas register-ID eller namn på affärsregister . Inkludera produktens Produkt-ID om du också associerar radobjektet med en produkt, som kommer att mappas som en radobjektsegenskap under importen.
Observera: när du importerar radobjekt med affärer kommer importen inte att uppdatera affärssumman. Om du vill uppdatera den associerade affärssumman kan du redigera radobjekten manuellt eller associera radobjekten med en affär i HubSpot.
- Samtal: Anteckningar om samtal. När du importerar nya Ringer rekommenderas det också att inkludera Aktivitet datum.
- E-post: E-postens brödtext och riktning.
- Möten: Beskrivning av mötet, starttid för mötet och sluttid för mötet. Vid import av nya möten rekommenderas det också att inkludera datum för Aktivitet. Värdena för starttid, sluttid och datum för aktivitet bör formateras som datum- och tidsegenskaper.
- Anteckningar: Anteckningens brödtext.
- Uppgifter: Uppgiftens titel och Förfallodatum . Förfallodatumet bör formateras som en egenskap för datum och tid.
Observera: även om det inte är obligatoriskt rekommenderas det att inkludera Aktivitetens datum 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 kommer Aktivitet date -värdena automatiskt att ställas in på datum och tid för importen.
Krav på att uppdatera befintliga register eller undvika dubbletter
För att uppdatera befintliga register och undvika dubbla register måste filerna innehålla en egenskap för unik identifiering för varje objekt. För alla objekt kan du exportera befintliga register och använda Register-ID som en unik identifierare, eller använda ett anpassat objekt som kräver unika värden. För kontakter kan du också använda E-post. För företag kan du också använda Företagets domännamn.
Om du importerar flera objekt och inkluderar Register ID rekommenderas att du skiljer filens kolumnrubriker för att matcha ID med rätt objekt (t.ex. en kolumn som heter Register ID - Kontakter och en annan som heter Register 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 egen egenskap med unikt värde för att ta bort dubbletter av kontakter, kommer egenskapen E-post fortfarande att kräva unika värden.
- Om du använder en anpassad unik värdeegenskap för att ta bort dubbletter av företag, kommer egenskapen Företagets domännamn inte att kräva unika värden. Detta innebär att du kan importera dubbla domäner för företag. Om du inte vill ha flera företag med samma domän bör du ta bort dubbla 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-post som unik identifierare för befintliga kontakter som har en sekundär e-postadress listad i HubSpot. Om du använder en sekundär e-post och inte inkluderar kolumnen Register ID i din fil kommer den sekundära e-posten inte att ersätta det primära registret. Men om du inkluderar både den sekundära e-posten och Register ID som kolumner i din fil, kommer den sekundära e-posten att ersätta den primära e-posten.
Krav på att associera register
Importera associationer i en fil
I en fil kan du associera två eller flera register per rad. Inkludera information om associerade register och/eller aktiviteter i samma rad och inkludera en unik identifierare för varje objekt. Om du vill associera ett register med flera aktiviteter eller register för ett annat objekt, inkluderar du registrets unika identifierare i flera rader för varje register som du vill associera.
Luke Danes är till exempel chef på Luke's Diner, men entreprenör på The 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 register-ID) och Företagets domännamn (eller register-ID) för varje företag.
Observera: om du inte inkluderar unika identifierare (t.ex. E-post, Företagets domännamn, Register-ID) kommer importen att skapa dubbla register i stället för att associera dem till samma register.
Om du importerar samma objekt associationer, finns det ytterligare krav.
Importera Associations i två filer
Om du vill associera register för två objekt i två filer använder du en gemensam kolumn för att ansluta registren i varje fil. Du kan se exempelfilerna för mer hjälp med att importera och associera register.
Samma objekt associationer
Du kan importera en fil för att associera poster med samma objekt i bulk. Under importen måste du markera en kryssruta för att inkludera associationer för samma objekt.
När du skapar din fil ska du inkludera information om de associerade registren i samma rad och inkludera en unik identifierare för varje register. Följande ytterligare krav är specifika för import av samma objekt:
- Minst ett register i ett registerpar måste redan finnas i HubSpot innan import. Du kan t.ex. 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-postdomänen/företagets domän som din unika identifierare. Sekundära e-postdomäner eller domäner stöds inte.
- Om du associerar flera register med ett register ska du separera registrens unika identifieringsvärden med ett semikolon i samma cell (t.ex. luke@lukesdiner. com; [email protected]; [email protected]).
I exempelfilen nedan är Rory och Jackson nya kontakter som associeras med unika etiketter till befintliga kontakter, med deras E-post-värden som unik identifierare. Sookie är en befintlig kontakt som associeras med två befintliga kontakter med samma associationsetikett. I den första raden är Associationsetiketten en del av ett etikettpar, vilket innebär att när importen är klar kommer det associerade registret att ha etiketten Parent och Rory kommer att ha den parade etiketten Child.

Parent/child associations
Om du vill skapa associationer mellan underordnade företag och moderföretag via import, läs mer om import av underordnade företag.
Anpassade Associationsetiketter (endastProfessional och Enterprise )
Om du vill importera associationsetiketter måste du inkludera en kolumn Associationsetikett . Denna kolumn bör endast läggas till om du vill lägga till etiketter för att beskriva associationer. Om du inte behöver etikettera associationer behövs inte kolumnen.
- Du måste skapa Associationsetiketter i HubSpot före import.
- Om du vill ange att en association för ett företag ska vara primär ska du inkludera värdet Primär i kolumnen Associationsetikett för den raden.
- Om du vill ange flera etiketter för att beskriva förhållandet mellan två register kan du inkludera flera värden för Associationsetikett i en cell, åtskilda av ett semikolon (t.ex. Manager; Faktureringskontakt).
- Om du importerar associationsetiketter i en import av flera filer måste du inkludera kolumnen Associationsetikett och en unik identifierare för objektet du associerar i samma fil.
- Om du importerar parade etiketter:
- För associationer mellan tvärobjekt ska du bara inkludera en av etiketterna i kolumnen Associationsetikett. Etiketterna kommer att tilldelas rätt objekt under importen.
- För associationer till samma objekt får registret i kolumnen Associated [unik identifierare] den etikett som läggs till under importen eller som ingår i filens etikettkolumn. Det andra registret i raden kommer att få den andra etiketten i paret.
Exempel på filer
I början av importen 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 exempel på filer.
