- Vidensbase
- CRM
- Import og eksport
- Opsætning af importfiler
Opsætning af importfiler
Sidst opdateret: 10 december 2025
Før du importerer data til HubSpot, skal du kontrollere, at dine filer overholder de krævede format- og tekniske begrænsninger. Nogle begrænsninger afhænger af abonnementet. Find ud af, hvilke filtyper der understøttes, hvordan du strukturerer og formaterer egenskabsværdier, og hvor mange rækker og filer du kan importere i en given periode.
Gennemgå, hvordan importværktøjet fungerer, og brug eksempel- eller genererede eksempel-filer til at forberede dine data. Når din fil er klar, kan du læse, hvordan du importerer.
Tekniske krav og begrænsninger
Alle filer, der importeres til HubSpot, skal:- Være en .csv-, .xlsx- eller .xls-fil.
- Kun have ét ark.
- Indeholde en overskriftsrække, hvor hver kolonneoverskrift svarer til en egenskab i HubSpot. Kolonneoverskrifterne kan organiseres i vilkårlig rækkefølge uden at påvirke importen. Du kan kontrollere, om der allerede findes en standardegenskab, der matcher din overskrift, eller oprette en brugerdefineret egenskab inden importen. Få mere at vide om egenskabskrav.

- Indeholde mindre end 1000 kolonner.
- Vær UTF-8-kodet, hvis der er tegn på fremmedsprog.
- Hvis du importerer en Excel-fil:
- Indeholde data, der ligger under Excel-regnearkets og -projektmappens maksimale grænser.
- Indeholde celler i talformat, når du importerer egenskaber for dato- og tidsvælger.
Der er yderligere tekniske begrænsninger for importværktøjet afhængigt af dit HubSpot-abonnement. Disse begrænsninger omfatter størrelsen og rækkebegrænsningerne for en importfil samt hvor mange filer og rækker du kan importere pr. dag.
- Hvis du bruger HubSpots gratis værktøjer, kan du:
- Importere filer på op til 20 MB.
- Udføre op til 50 importoperationer om dagen.
- Importere op til 500.000 rækker om dagen. Hvis du importerer en fil, der indeholder mere end 500.000 rækker, vil det tage flere dage at gennemføre.
- Hvis din konto har et Smart CRM- eller et Starter-, Professional- eller Enterprise-abonnement, kan du:
- Importere filer på op til 512 MB.
- Udføre op til 500 importoperationer om dagen.
- Importere op til 10.000.000 rækker om dagen med en grænse på 1.048.576 rækker pr. fil. Hvis du importerer via import-API'en, kan du importere op til 80.000.000 rækker om dagen.
Disse begrænsninger gælder for en rullende 24-timers periode og nulstilles ikke på et bestemt tidspunkt af dagen. Få mere at vide om ditHubSpot-abonnement og dets begrænsninger.
Formatering af værdier
For hver række i din importfil kan du tilføje værdier til egenskabskolonnerne. Formateringen af en værdi afhænger af egenskabsfeltets type og målet med importen.
Formater værdier baseret på egenskabsfeltets
typeAfhængigt af egenskabsfeltets type er der specifikke formateringskrav:
| Felt type | Krav |
| Dato-vælger Dato- og tidsvælger |
Måneder kan være et tal, tre bogstaver eller et fuldt navn (10, OKT, okt, OKTOBER, oktober), år kan være to eller fire cifre (2023, 23), og separatorer kan være en skråstreg, bindestreg eller punktum (28/10/2023, 28-10-2023, 10.28.2023). Gyldige datoformater er dag måned år (f.eks. 28/10/2023), måned dag år (f.eks. 10-28-23) eller år måned dag (f.eks. 2023.OCT.28). Hvis du har angivet valideringsregler, skal dine importerede værdier følge reglerne, ellers importeres de ikke. |
| Dato- og tidsvælger |
Tidsstempler kan tilføjes som hh:mm (28/10/2020 14:30) i alle filtyper eller som et UNIX-tidsstempel i millisekunder i CSV-filer eller en Excel-fil med celler i tekstnummerformatet. Hvis du ikke inkluderer et tidsstempel, indstilles tiden som standard til midnat. |
| Varighed |
For egenskaber, der indeholder en varighed, såsom egenskaben Opkaldsvarighed, skal dine værdier formateres som et UNIX-tidsstempel i millisekunder. Få mere at vide om, hvordan du formaterer tidsstempelværdier, og hvordan du konverterer en dato til UNIX-format. |
| Opregning |
Værdierne i din importfil skal matche enten etiketten eller den interne værdi af egenskabens definerede indstillinger. For HubSPots standardopregningsegenskaber (f.eks. livscyklusfase, branche) skal værdierne matche den interne værdi eller etiketten på engelsk. |
| Fil |
For at tilføje eksisterende filer til en filegenskab skal du angive fil-id'et som din værdi. Du kan finde en fils id i afsnittet Generelt i en fils detaljer. |
| Flere afkrydsningsfelter |
For at importere flere værdier skal du tilføje et semikolon mellem hver værdi uden mellemrum (værdi 1;værdi 2). Disse egenskabsindstillinger skal oprettes før importen. For at tilføje eller tilføje værdier skal du tilføje et semikolonfør den første værdi (;værdi 3;værdi 4). Dette tilføjer værdien i stedet for at overskrive den eksisterende egenskabsværdi. Få mere at vide om import af flere afkrydsningsfeltværdier. |
| Tal |
Formater værdien ud fra den type talegenskab, der er oprettet:
|
| Enkelt afkrydsningsfelt |
Opret en kolonne til feltet med enkelt afkrydsningsfelt, og indstil værdien på hver linje til SandellerJafor at vise Ja eller afkrydset i HubSpot ellerFalskellerNejfor at vise Nej eller ikke afkrydset i HubSpot. |
| Termegenskaber |
Linjepostens egenskab Term skal tilføjes i ISO-8601-periodeformaterne PnYnMnD eller PnW. For eksempel P12M eller P24M for årlige perioder. Hvis feltet efterlades tomt, indstilles standardperioder. |
| Tekst |
Hvis du har angivet valideringsregler, skal dine importerede værdier følge reglerne, ellers importeres de ikke. |
| Bruger (ejer) |
Sådan tildeler du en ejer til en post eller aktivitet under importen:
|
Yderligere kontakt-e-mails eller virksomhedsdomaine
Hvis du importerer kontakter med mere end én e-mailadresse, skal du inkludere en kolonne med yderligere e-mailadresser med deres sekundære e-mails. Hvis du importerer virksomheder med mere end ét domænenavn, skal du inkludere en kolonnemed yderligere domæner med deres sekundære domæner. For at inkludere flere e-mails eller domæner i en celle skal du adskille værdierne med semikoloner (f.eks. email@email.com; emailtwo@email.com).
Hvis du importerer for at oprette kontakter eller virksomheder, kan du ikke indstille en ny kontakts e-mail eller en ny virksomheds virksomhedsdomenenavn til en e-mail eller et domæne, der er en eksisterende yderligere e-mail/domæne for en anden post.
Tomme celler
Importværktøjet ignorerer tomme celler i et regneark, så når du importerer nye egenskabsdata, skal du lade cellerne være tomme for poster uden en værdi for egenskaben. Hvis en eksisterende post allerede har en værdi for egenskaben i HubSpot, vil tomme celler ikke slette den eksisterende egenskabsværdi. For at slette eksisterende egenskabsværdier i bulk kan du manuelt redigere værdierne eller bruge workflow-handlingen Rediger poster .Samarbejdspartnere til aftaler
Hvis du tilføjer samarbejdspartnere til en aftale via import, skal du inkludere en overskriftfor samarbejdspartnere til aftaler. For hver celle skal du inkludere to eller flere brugere, adskilt af semikoloner (f.eks. user1@example.com;user2@example.com).Produktperiode og faktureringshyppighed
Hvis du importerer en værdi for egenskaben Term, kan du formatere værdien i kolonnen Term som et tal i måneder (f.eks. 10 for 10 måneder), som PXM, hvor X er antallet af måneder (f.eks. P6M for en periode på 6 måneder) eller PXY, hvor X er antallet af år (f.eks. P1Y for en periode på 1 år).
Hvis du importerer en faktureringsfrekvens-egenskabsværdi, skal du bruge månedligt, årligt eller kvartalsvist, hvis produktet har en tilbagevendende pris. Lad cellen være tom, hvis produktet har en engangspris.
Påkrævede egenskaber
Afhængigt af hvilke objekter eller aktiviteter du importerer, er følgende egenskaber påkrævede for at oprette poster og skal medtages som kolonneoverskrifter i dine filer. Hvis du opdaterer poster, skal du medtage en unik identifikator (f.eks. post-id, e-mail, virksomhedens domænenavn).
Selvomdet ikke er påkrævet, kan du importere yderligere egenskaber for hvert objekt, herunder brugerdefinerede og standardegenskaber. Se standardegenskaberne for kontakter, virksomheder, aftaler, billetter, opkald, e-mails, møder, noter og opgaver. Du kan også se alle egenskaber og deres værdier i dine egenskabsindstillinger.
- Kontakter: mindst én af følgende: fornavn, efternavn eller e-mail.
- Virksomheder: mindst én af navn eller virksomhedens domænenavn.
Bemærk: Egenskaben Virksomhedens domænenavn accepterer kun værdier op til topdomænet (f.eks. .com, .edu). Værdier med streng efter (f.eks. .edu/home) fjernes automatisk, når du importerer.
- Aftaler: hvis du opretter nye aftaler,aftalenavn, pipeline og aftalestadium.
- Billetter: Hvis du opretter nye billetter, skal du angive billetnavn, pipeline og billetstatus.
- Aftaler: Aftalestart. Aftalestarten skal formateres som endato-tid-egenskab.
- Kurser: Kursusnavn.
- Oplysninger: Navn.
- Tjenester: Navn, pipeline og pipeline-fase.
- Produkter: Hvis du opdaterer produkter, skal du angive rekord-id eller SKU.
- Hvis du opdaterer produkter i en konto med én valuta,enhedspris og navn.
- Hvis du opdaterer produkter i en konto med flere valutaer,pris [valutaforkortelse] (f.eks. pris USD) og navn.
- Ordrer: Navn, pipeline og pipeline-fase.
- Indkøbskurve: Navn.
- Linjeposter: Navn, mængde, pris ogdet tilknyttede aftales ID-nummer eller aftalenavn. Inkluder produktets produkt-ID , hvis du også knytter linjeposten til et produkt, som vil blive kortlagt som en linjepostsegenskab under importen.
Bemærk: Når du importerer linjeposter med aftaler, opdateres aftalens beløb ikke under importen. For at opdatere det tilknyttede aftalebeløb kan du manuelt redigere linjeposterne eller knytte linjeposterne til en aftale i HubSpot.
- Opkald: Opkaldsnoter. Når du importerer nye opkald, anbefales det også at medtage Aktivitetsdato.
- E-mails: E-mailtekstog e-mailretning.
- Møder:Møde beskrivelse, Møde starttidspunkt og Møde sluttidspunkt. Når du importerer nye møder, anbefales det også at medtage aktivitetsdato. Starttidspunkt, sluttidspunkt og aktivitetsdato skal formateres som dato-tid-egenskaber.
- Noter: Notetekst.
- Opgaver:Opgavens titelogforfaldsdato. Forfaldsdatoen skal formateres som en dato-tid-egenskab.
Bemærk: Det er ikke obligatorisk, men det anbefales at medtage aktivitetsdato, når du importerer nye aktiviteter, for at angive dato og klokkeslæt for aktiviteten. Hvis du ikke medtager denne egenskab, indstilles aktivitetsdato automatisk til dato og klokkeslæt for importen.
Krav til opdatering af eksisterende poster eller undgåelse
af
dubletter
For at opdatere eksisterende poster og undgå dubletter skal dine filer indeholde en unik identifikationsegenskab for hvert objekt. For alle objekter kan du eksportere eksisterende poster og bruge post-id'et som en unik identifikator eller bruge en brugerdefineret egenskab, der kræver unikke værdier. For kontakter kan du også bruge e-mail. For virksomheder kan du også bruge virksomhedens domænenavn.
Hvis du importerer flere objekter og inkluderer post-id'er, anbefales det at differentiere filens kolonneoverskrifter, så id'et matcher det korrekte objekt (f.eks. en kolonne kaldet Post-id – Kontakter og en anden kaldet Post-id – Virksomheder).
Bemærk:Følgende adfærd gælder, hvis e-mail eller virksomhedens domænenavn er inkluderet i din fil:
- Hvis du bruger en brugerdefineret unik værdi til at fjerne dubletter blandt kontakter, kræver egenskaben E-mail stadig unikke værdier.
- Hvis du bruger en brugerdefineret unik værdi-egenskab til at fjerne dubletter blandt virksomheder, kræver egenskaben Virksomhedens domænenavn ikke unikke værdier. Det betyder, at du kan importere dubletter af virksomheders domæner. Hvis du ikke ønsker flere virksomheder med samme domæne, skal du fjerne dubletter af domæner fra din fil, før du importerer, eller i stedet bruge Virksomhedens domænenavn som din unikke identifikator.
- Du kan bruge en sekundær e-mail som unik identifikator for eksisterende kontakter, der har en sekundær e-mailadresse angivet i HubSpot. Hvis du bruger en sekundær e-mail og ikke inkluderer kolonnen RecordID i din fil, erstatter den sekundære e-mail ikke den primære e-mail. Hvis du imidlertid inkluderer både den sekundære e-mail og Record ID som kolonner i din fil, erstatter den sekundære e-mail den primære e-mail.
Krav til at knytte poster sammen
Importer sammenkædninger i én fil
I én fil kan du knytte to eller flere poster sammen pr. række. Medtag oplysninger om sammenkædede poster og/eller aktiviteter i samme række, og medtag en unik identifikator for hvert objekt. For at knytte en post til flere aktiviteter eller poster for et andet objekt skal du medtage postens unikke identifikator i flere rækker for hver post, du vil knytte sammen.
For eksempel er Luke Danes manager hos Luke's Diner, men entreprenør hos The Dragonfly Inn. For at knytte ham til begge virksomheder skal du inkludere to rækker for Luke Danes med kolonnerne E-mail (eller Record ID) og Virksomhedens domænenavn (eller Record ID) for hver virksomhed.
Bemærk: Hvis du ikke inkluderer unikke identifikatorer (f.eks. e-mail, virksomhedens domænenavn, post-id), opretter importen duplikerede poster i stedet for at knytte hver enkelt til den samme post.

Hvis du importerer tilknytninger til samme objekt, er der yderligere krav.
Importer tilknytninger i to filer
For at knytte poster fra to objekter i to filer skal du bruge en fælles kolonne til at forbinde posterne i hver fil. Du kan se eksemplerne på filer for at få mere hjælp til at importere og knytte poster.
Samme objektsammenkædninger
Du kan importere en fil for at sammenkæde poster af det samme objekt i bulk. Under importprocessen skal du markere et afkrydsningsfelt for at inkludere samme objektsammenkædninger.
Når du opsætter din fil, skal du inkludere oplysninger om de sammenkædede poster i samme række og inkludere en unik identifikatorfor hver post. Følgende yderligere krav gælder specifikt for import af samme objekter:
- Mindst én post i et postpar skal allerede findes i HubSpot, før importen kan finde sted. Du kan f.eks. importere en ny kontakt og knytte den til en eksisterende kontakt, men dukan ikkeimportere for at oprette og knytte to nye kontakter.
- Når du knytter eksisterende kontakter/virksomheder, kan du kun bruge den primæree-mail/virksomhedsdomæne som din unikke identifikator. Sekundære e-mails eller domæner understøttes ikke.
- Hvis du knytter flere poster til én post, skal du adskille posternes unikke identifikationsværdier med et semikolon i samme celle (f.eks.luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com).
I eksemplet nedenfor er Rory og Jackson nye kontakter, der knyttes til unikke etiketter til eksisterende kontakter ved hjælp af derese-mail-værdiersom unikke identifikatorer. Sookie er en eksisterende kontakt, der knyttes til to eksisterende kontakter med samme etiket. I den første række er tilknytningsetiketten en del af et etiketpar, hvilket betyder, at når importen er afsluttet, vil den tilknyttede post have etikettenForælder, og Roryvil have den parrede etiket,Barn.
Forældre/barn-tilknytninger
For at oprette tilknytninger mellem datterselskaber og moderselskaber via import kan du læse mere om import af datterselskaber.
Brugerdefinerede tilknytningsmærker
Abonnement kræves Der kræves et Professional- eller Enterprise-abonnement for at kunne bruge brugerdefinerede tilknytningsmærker.
For at importere associeringsmærker skal du inkludere en kolonne med associeringsmærker. Denne kolonne skal kun tilføjes, hvis du vil tilføje mærker til at beskrive associeringer. Hvis du ikke har brug for at mærke associeringer, er kolonnen ikke påkrævet.
- Du skal oprette tilknytningsetiketterne i HubSpot, før du importerer.
- For at angive en virksomhedsassociation som primær skal du inkludere værdien Primær i kolonnen Associationsmærkefor den pågældende række.
- For at angive flere etiketter til at beskrive forholdet mellem to poster kan du inkludere flere associeringsetiketteværdier i én celle, adskilt af et semikolon (f.eks. Manager; Faktureringskontakt).
- Hvis du importerer tilknytningsetiketter i en import af flere filer, skal du inkludere kolonnen Tilknytningsetiket og en unik identifikator for det objekt, du tilknytter, i samme fil.
- Hvis du importererparrede etiketter:
- For tværobjektassociationer skal du kun medtage en af etiketterne i kolonnen Associationsetiket. Etiketterne tildeles det korrekte objekt under importprocessen.
- For tilknytninger af samme objekt vil posten ikolonnen Tilknyttet [unik identifikator] modtage den etiket, der er tilføjet underimportprocessen eller inkluderet i filens etiketkolonne. Den anden post i rækken vil modtage den anden etiket i parret.
Eksempel på filer
I begyndelsen af importprocessen kan du generere en eksempel fil med de krævede egenskaber for de valgte objekter og aktiviteter. Hvis du vil se flere eksempler med yderligere egenskaber, kan du læse denne artikel med eksempel filer.
