- Kunnskapsdatabase
- CRM
- Import og eksport
- Formater importfiler
Formater importfiler
Sist oppdatert: 14 april 2026
Før du importerer data til HubSpot, må du kontrollere at filene dine oppfyller kravene til format og tekniske begrensninger. Noen begrensninger avhenger av abonnementet ditt. Sørg for å vite hvilke filtyper som støttes, hvordan du skal strukturere og formatere egenskapsverdier, og hvor mange rader og filer du kan importere i løpet av en gitt periode.
Før du importerer, bør du lese artikkelen «Kom i gang med import».
Tekniske krav og begrensninger
Alle filer som importeres til HubSpot må:- Være en .csv-, .xlsx- eller .xls-fil.
- Inneholde bare ett ark.
- Inneholde en overskriftsrad der hver kolonneoverskrift tilsvarer en egenskap i HubSpot. Kolonneoverskriftene kan organiseres i hvilken som helst rekkefølge uten at det påvirker importen. Du kan sjekke om det allerede finnes en standardegenskap som samsvarer med overskriften din, eller opprette en tilpasset egenskap før du importerer. Les mer om krav til egenskaper.

- Inneholde færre enn 1 000 kolonner.
- Være UTF-8-kodet hvis filen inneholder tegn fra fremmedspråk.
- Hvis du importerer en Excel-fil:
- Inneholde data som holder seg innenfor Excels maksimumsgrenser for regneark og arbeidsbøker.
- Inneholde celler i tallformat når du importerer egenskaper for dato- og tidsvelger.
Det gjelder ytterligere tekniske begrensninger for importverktøyet, avhengig av HubSpot-abonnementet ditt. Disse begrensningene omfatter størrelsen på og antall rader i en importfil, samt hvor mange filer og rader du kan importere per dag.
- Hvis du bruker HubSpots gratisverktøy, kan du:
- Importere filer på opptil 20 MB.
- Gjennomføre opptil 50 importer per dag.
- Importere opptil 500 000 rader per dag. Filer som inneholder mer enn 500 000 rader, vil ta flere dager å fullføre.
- Starte opptil 3 importer samtidig. Opptil 2 av disse importer kan være større enn 10 000 rader. Hvis du starter 4 eller flere samtidige importer, vil de bli satt i kø.
- Hvis kontoen din har et Smart CRM-abonnement eller et Starter-, Professional- eller Enterprise -abonnement, kan du:
- Importere filer på opptil 512 MB.
- Gjennomføre opptil 500 importer per dag.
- Importere opptil 10 000 000 rader per dag, med en grense på 1 048 576 rader per fil. Hvis du importerer via import-API-et, kan du importere opptil 80 000 000 rader per dag.
- Starte opptil 3 importer samtidig. Opptil 2 av disse importer kan være større enn 10 000 rader. Hvis du starter 4 eller flere samtidige importer, vil de bli satt i kø.
Disse grensene gjelder for en løpende 24-timers periode og tilbakestilles ikke på et bestemt tidspunkt på dagen. Lær mer omHubSpot-abonnementetdittog begrensningene.
Formater egenskapsverdier
For hver rad i importfilen din kan du legge til verdier for egenskapskolonnene. Formateringen av en verdi avhenger av egenskapsfeltets type og målet med importen.
Formater verdier basert på egenskapsfeltets type
Avhengig av egenskapsfeltets type er det spesifikke formateringskrav:
| Feltetype | Krav |
| Dato-velger Dato- og klokkeslettvelger |
Måneder kan være et tall, tre bokstaver eller et fullstendig navn (10, OCT, Oct, OCTOBER, October), år kan være to eller fire sifre (2023, 23), og skilletegn kan være en skråstrek, bindestrek eller punktum (10/28/2023, 10-28-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 angitt valideringsregler, må de importerte verdiene følge reglene, ellers blir de ikke importert. |
| Dato- og tidsvelger |
Tidsstempler kan legges til som Tidssoneforskjeller i forhold til tidssonen for kontoen din kan legges til som |
| Varighet |
For egenskaper som inneholder en varighet, for eksempel egenskapen Anropsvarighet, må verdiene dine formateres som en UNIX-tidsstempel i millisekunder. Lær mer om hvordan du formaterer tidsstempelverdier og hvordan du konverterer en dato til UNIX-format. |
| Oppregning |
Verdiene i importfilen din må samsvare med enten etiketten eller den interne verdien til egenskapens definerte alternativer. For HubSpots standard oppregningsegenskaper (f.eks. Livssyklusfase, Bransje) må verdiene samsvare med den interne verdien eller etiketten på engelsk. |
| Fil |
For å legge til eksisterende filer til en filegenskap, inkluderer du fil-ID-en som verdi. Du finner en fils ID i delen Generelt i filens detaljer. |
| Flere avmerkingsbokser |
For å importere flere verdier, legg til et semikolon mellom hver verdi uten mellomrom (verdi 1;verdi 2). Disse egenskapsalternativene må opprettes før importen. For å legge til eller legge til verdier, legg til et semikolonfør den første verdien (;verdi 3;verdi 4). Dette vil legge til verdien i stedet for å overskrive den eksisterende egenskapsverdien. Lær mer om å importere flere avkrysningsboksverdier. |
| Tall |
Formater verdien basert på typen tall-egenskap som er opprettet:
|
| Enkelt avkrysningsfelt |
Opprett en kolonne for feltet med enkelt avkrysningsrute, og sett verdien på hver linje til TrueellerYesfor å vise som Yes eller avkrysset i HubSpot, ellerFalseellerNofor å vise som No eller ikke avkrysset i HubSpot. |
| Periodeegenskaper |
Linjeelementegenskapen «Term» bør legges til i ISO-8601-periodeformater av typen PnYnMnD eller PnW. For eksempel P12M eller P24M for årlige perioder. Hvis feltet står tomt, vil standardperioder bli angitt. |
| Tekst |
Hvis du har angitt valideringsregler, må de importerte verdiene følge reglene, ellers blir de ikke importert. |
| Bruker (eier) |
Slik tilordner du en eier til en post eller aktivitet under importen:
|
Ekstra kontakt-e-postadresser eller bedriftsdomener
Hvis du importerer kontakter med mer enn én e-postadresse, må du inkludere en kolonne for «Ekstra e-postadresser» med deres sekundære e-postadresser. Hvis du importerer bedrifter med mer enn ett domenenavn, må du inkludere en kolonnefor «Ekstra domener» med deres sekundære domener. For å inkludere flere e-postadresser eller domener i en celle, må du skille verdiene med semikolon (f.eks. email@email.com; emailtwo@email.com).
Hvis du importerer for å opprette kontakter eller selskaper, kan du ikke angi e-postadressen til en ny kontakt eller domenenavnet til et nytt selskap til en e-postadresse eller et domene som allerede er en eksisterende tilleggs-e-postadresse/et tilleggsdomene for en annen post.
Tomme celler
Importverktøyet ignorerer tomme celler i et regneark, så når du importerer nye egenskapsdata, må du la cellene stå tomme for poster uten en verdi for egenskapen. Hvis en eksisterende post allerede har en verdi for egenskapen i HubSpot, vil tomme celler ikke slette den eksisterende egenskapsverdien. For å slette eksisterende egenskapsverdier i bulk, kan du redigere verdiene manuelt eller bruke arbeidsflyt-handlingen «Rediger poster» .Medarbeidere i en avtale
Hvis du legger til medarbeidere i en avtale via import, må du inkludere en overskriftfor «Medarbeidere i avtalen ». For hver celle må du inkludere to eller flere brukere, atskilt med semikolon (f.eks. user1@example.com;user2@example.com).Produktløpetid og faktureringsfrekvens
Hvis du importerer en Term-egenskapsverdi, kan du formatere verdien i Term-kol onnen som et tall i måneder (f.eks. 10 for 10 måneder), som PXM der X er antall måneder (f.eks. P6M, for en periode på 6 måneder) eller PXYder X er antall år (f.eks. P1Y, for en periode på 1 år).
Hvis
du importerer
en egenskapsverdi for faktureringsfrekvens, bruk «månedlig», «årlig» eller «kvartalsvis» hvis produktet har en gjentakende pris. La cellen stå tom hvis produktet har en engangspris.
Inkluder obligatoriske egenskaper
Avhengig av hvilke objekter eller aktiviteter du importerer, er følgende egenskaper obligatoriske for å opprette poster, og må inkluderes som kolonneoverskrifter i filene dine. Hvis du oppdaterer poster, må du inkludere en unik identifikator (f.eks. post-ID, e-post, bedriftsdomenenavn).
Selv omdet ikke er påkrevd, kan du importere tilleggsegenskaper for hvert objekt, inkludert tilpassede og standardegenskaper. Se standardegenskapene for kontakter, bedrifter, avtaler, billetter, samtaler, e-poster, møter, notater og oppgaver. Du kan også se alle egenskaper og verdiene deres i egenskapsinnstillingene dine.
- Kontakter: minst ett av fornavn, etternavn eller e-post.
- Bedrifter: minst én av Navn eller Bedriftsdomenenavn.
Merk: Egenskapen Bedriftsdomenenavn godtar kun verdier opp til toppdomenet (f.eks. .com, .edu). Verdier med strenger etter seg (f.eks. .edu/home) fjernes automatisk når du importerer.
- Avtaler: hvis du oppretter nye avtaler,Avtalenavn, Pipeline og Avtalestadium.Pipeline ogAvtalestadium må samsvare med eksisterende alternativer i kontoen din, og Avtalestadium må være et gyldig stadium i den pipelinen.
- Billetter: Hvis du oppretter nye billetter, billettnavn, pipeline og billettstatus.
- Avtaler: Avtalestart. Avtalestarten skal formateres som endato- og klokkeslett-egenskap.
- Kurs: Kursnavn.
- Oppføringer: Navn.
- Tjenester: Navn, pipeline og pipelinestadium.
- Produkter: Hvis du oppdaterer produkter, Record ID eller SKU.
- Hvis du oppdaterer produkter i en konto med én valuta,enhetspris og navn.
- Hvis du oppdaterer produkter i en konto med flere valutaer,Pris [Valutaforkortelse] (f.eks. Pris USD) og Navn.
- Bestillinger: Navn, pipeline og pipelinestadium.
- Handlekurver: Navn.
- Linjeposter: Navn, Antall, Pris ogden tilknyttede avtalens Record-ID eller avtalenavn. Inkluder produktets produkt-ID hvis du også knytter linjeposten til et produkt, som vil bli tilordnet som en linjepost-egenskap under importen.
Merk: Når du importerer linjeposter med avtaler, vil importen ikke oppdatere avtalebeløpet. For å oppdatere det tilknyttede avtalebeløpet kan du redigere linjepostene manuelt eller knytte linjepostene til en avtale i HubSpot.
- Samtaler: Samtalemerknader. Når du importerer nye samtaler, anbefales det også å inkludere Aktivitetsdato.
- E-post: E-posttekstog E-postadresse.
- Møter:Møtebeskrivelse, Møtets starttidspunkt og Møtets sluttidspunkt. Når du importerer nye møter, anbefales det også å inkludere Aktivitetsdato. Verdiene for starttid, sluttid og aktivitetsdato bør formateres som dato- og klokkeslett-egenskaper.
- Notater: Notattekst.
- Oppgaver:Oppgavetittelogforfallsdato. Forfallsdatoen bør formateres som en dato-tid-egenskap.
Merk: Selv om det ikke er påkrevd, anbefales det å inkludere Aktivitetsdato når du importerer nye aktiviteter for å spesifisere dato og klokkeslett for når en aktivitet fant sted. Hvis du ikke inkluderer denne egenskapen, settes verdiene for Aktivitetsdato automatisk til dato og klokkeslett for importen.
Krav for å oppdatere eksisterende poster eller unngå duplikater
For å oppdatere eksisterende poster og unngå duplikatposter må filene dine inneholde en unik identifikator for hvert objekt. For alle objekter kan du eksportere eksisterende poster og bruke post-ID som unik identifikator, eller bruke en tilpasset egenskap som krever unike verdier. For kontakter kan du også bruke e-post. For selskaper kan du også bruke selskapets domenenavn.
Hvis du importerer flere objekter og inkluderer post-ID-er, anbefales det å skille mellom filkolonneoverskriftene for å matche ID-en med riktig objekt (f.eks. en kolonne kalt Post-ID – Kontakter og en annen kalt Post-ID – Bedrifter).
Merk:Følgende gjelder hvis E-post eller Bedriftsdomenenavn er inkludert i filen din:
- Hvis du bruker en egendefinert egenskap med unike verdier for å fjerne duplikater av kontakter, vil e-post -egenskapen fortsatt kreve unike verdier.
- Hvis du bruker en egendefinert egenskap med unike verdier for å fjerne duplikater av selskaper, vil egenskapen Selskapets domenenavn ikke kreve unike verdier. Dette betyr at du kan importere dupliserte selskapsdomener. Hvis du ikke ønsker flere selskaper med samme domene, bør du fjerne dupliserte domener fra filen din før import, eller bruke Selskapets domenenavn som unik identifikator i stedet.
- Du kan bruke en sekundær e-postadresse som unik identifikator for eksisterende kontakter som har en sekundær e-postadresse oppført i HubSpot. Hvis du bruker en sekundær e-postadresse og ikke inkluderer kolonnen «RecordID» i filen din, vil den sekundære e-postadressen ikke erstatte den primære e-postadressen. Hvis du derimot inkluderer både den sekundære e-postadressen og «Record ID» som kolonner i filen din, vil den sekundære e-postadressen erstatte den primære e-postadressen.
Krav for å knytte poster
Importer tilknytninger i én fil
I én fil kan du knytte to eller flere poster per rad. Ta med informasjon om tilknyttede poster og/eller aktiviteter i samme rad, og inkluder en unik identifikator for hvert objekt. For å knytte én post til flere aktiviteter eller poster fra et annet objekt, må du inkludere postens unike identifikator i flere rader for hver post du ønsker å knytte.
For eksempel er Luke Danes leder ved Luke's Diner, men entreprenør ved The Dragonfly Inn. For å knytte ham til begge selskapene, må du inkludere to rader for Luke Danes med kolonnene E-post (eller post-ID) og Selskapets domenenavn (eller post-ID) for hvert selskap.
Merk: Hvis du ikke inkluderer unike identifikatorer (f.eks. E-post, Bedriftsdomenenavn, Post-ID), vil importen opprette dupliserte poster i stedet for å knytte hver til den samme posten.

Hvis du importerer tilknytninger mellom samme objekt, er det ytterligere krav.
Importer tilknytninger i to filer
For å knytte poster fra to objekter i to filer sammen, må du bruke en felles kolonne til å koble postene i hver fil. Du kan se eksempelfilene for mer hjelp til å importere og knytte poster sammen.
Koblinger mellom samme objekt
Du kan importere én fil for å koble sammen poster av samme objekt i bulk. Under importprosessen må du merke av i en boks for å inkludere koblinger mellom samme objekt.
Når du setter opp filen, må du inkludere informasjon om de tilknyttede postene i samme rad og inkludere en unik identifikatorfor hver post. Følgende tilleggskrav gjelder spesifikt for import av samme objekt:
- Minst én post i et postpar må allerede eksistere i HubSpot før import. Du kan for eksempel importere en ny kontakt og knytte den til en eksisterende kontakt, men dukan ikkeimportere for å opprette og knytte to nye kontakter.
- Når du knytter eksisterende kontakter/selskaper, kan du bare bruke den primæree-postadressen/selskapets domene som unik identifikator. Sekundære e-postadresser eller domener støttes ikke.
- Hvis du knytter flere poster til én post, må du skille postenes unike identifikatorverdier med et semikolon i samme celle (f.eks.luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com).
I eksempelfilen nedenfor er Rory og Jackson nye kontakter som knyttes til eksisterende kontakter med unike etiketter, ved å brukee-postverdienederes som unik identifikator. Sookie er en eksisterende kontakt som knyttes til to eksisterende kontakter med samme etikett. I den første raden er tilknytningsetiketten en del av et etikettpar, noe som betyr at når importen er fullført, vil den tilknyttede posten ha etiketten«Parent», og Roryvil ha den tilhørende etiketten«Child».
Foreldre/barn-tilknytninger
For å opprette barn-foreldre-tilknytninger via import, kan du lese mer om import av datterselskaper.
Tilpassede tilknytningsetiketter
Abonnement påkrevd Det kreves et Professional- eller Enterprise-abonnement for å bruke tilpassede tilknytningsetiketter.
For å importere tilknytningsetiketter må du inkludere en kolonne for tilknytningsetiketter. Denne kolonnen bør bare legges til hvis du vil legge til etiketter for å beskrive tilknytninger. Hvis du ikke trenger å merke tilknytninger, er kolonnen ikke nødvendig.
- Du må opprette tilknytningsetikettene i HubSpot før du importerer.
- For å angi en selskapsassosiasjon som primær, inkluderer du verdien Primær i kolonnen Assosiasjonsetikettfor den aktuelle raden.
- For å angi flere etiketter for å beskrive forholdet mellom to poster, kan du inkludere flere tilknytningsetikettverdier i én celle, atskilt med semikolon (f.eks. Leder; Faktureringskontakt).
- Hvis du importerer tilknytningsetiketter i en import av flere filer, må du inkludere kolonnen Tilknytningsetikett og en unik identifikator for objektet du knytter til, i samme fil.
- Hvis du importererparvise etiketter:
- For assosiasjoner på tvers av objekter skal du bare inkludere én av etikettene i kolonnen «Assosiasjonsetikett ». Etikettene vil bli tilordnet det riktige objektet under importprosessen.
- For tilknytninger til samme objekt vil posten ikolonnen Tilknyttet [unik identifikator] motta etiketten som er lagt til iimportprosessen eller inkludert i filens etikettkolonne. Den andre posten i raden vil motta den andre etiketten i paret.
Eksempelfiler
I begynnelsen av importprosessen kan du generere en eksempelfil med de nødvendige egenskapene for de valgte objektene og aktivitetene. Hvis du vil se flere eksempler med tilleggsegenskaper, kan du se denne artikkelen med eksempelfiler.
Neste trinn
Nå som importfilen din er ferdig, følger du de aktuelle importinstruksjonene:
