- Kunnskapsdatabase
- CRM
- Import og eksport
- Formater importfiler
Formater importfiler
Sist oppdatert: 28 august 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. Sett deg inn i 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 kun ett regneark.
- Inneholde en overskriftsrad der hver kolonneoverskrift tilsvarer en egenskap i HubSpot. Kolonneoverskriftene kan ordnes 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ær 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 tidsvelgeren.
Det gjelder ytterligere tekniske begrensninger for importverktøyet, avhengig av hvilket HubSpot-abonnement du har. 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 inneholde mer enn 10 000 rader. Hvis du starter 4 eller flere importer samtidig, 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 importeringer samtidig. Opptil 2 av disse importeringene kan omfatte mer enn 10 000 rader. Hvis du starter 4 eller flere samtidige importeringer, 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. Les 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 formålet med importen.
Formater verdier basert på egenskapsfeltets type
Avhengig av egenskapsfeltets type er det spesifikke formateringskrav:
| Felttype | Krav |
| Datovelger 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 «Samtalens varighet», må verdiene formateres som en UNIX-tidsstempel i millisekunder. Les mer om hvordan du formaterer tidsstempelverdier og hvordan du konverterer en dato til UNIX-format. |
| Oppregning |
Verdiene i importfilen må samsvare med enten etiketten eller den interne verdien til egenskapens definerte alternativer. For HubSpots standardoppregningsegenskaper (f.eks. «Livscyklusfase» og «Bransje») må verdiene samsvare med den interne verdien eller etiketten på engelsk. |
| Fil |
For å legge til eksisterende filer i en filegenskap, må du oppgi fil-ID-en som verdi. Du finner filens 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. Les mer om å importere flere avkrysningsboksverdier. |
| Tall |
Formater verdien basert på typen tall-egenskap som er opprettet:
|
| Enkelt avkryssingsfelt |
Opprett en kolonne for feltet med én avkryssingsrute, og sett verdien på hver linje til «True»eller«Yes»for å vise «Yes» eller avkrysset i HubSpot, eller«False»eller«No»for å vise «No» eller ikke avkrysset i HubSpot. |
| Periodeegenskaper |
Linjevareegenskapen «Løpetid» bør legges til i ISO-8601-periodeformater som PnYnMnD eller PnW. For eksempel P12M eller P24M for årlige løpetider. Hvis feltet står tomt, vil standardløpetider 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 e-postadresser for kontakter 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 selskapsdomenenavnet til et nytt selskap til en e-postadresse eller et domene som allerede er oppgitt som en 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» .Samarbeidspartnere i avtaler
Hvis du legger til samarbeidspartnere i en avtale via import, må du inkludere en overskriftfor «Samarbeidspartnere i avtalen ». For hver celle må du oppgi to eller flere brukere, atskilt med semikolon (f.eks. user1@example.com;user2@example.com).Produktløpetid og faktureringsfrekvens
Hvis du importerer en egenskapsverdi for «Løpetid», kan du formatere verdien i kolonnen «Løpetid» 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 løpetid på 6 måneder) eller PXYder X er antall år (f.eks. P1Y for en løpetid på 1 år).
Hvis
du importerer
en egenskapsverdi for «Faktureringsfrekvens», bruk «månedlig», «årlig» eller «kvartalsvis» hvis produktet har en gjentakende pristype. 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, bedriftens domenenavn).
Selv omdet ikke er påkrevd, kan du importere flere egenskaper for hvert objekt, inkludert tilpassede og standardegenskaper. Se standardegenskapene for kontakter, bedrifter, avtaler, saker, samtaler, e-poster, møter, notater og oppgaver. Du kan også se alle egenskaper og deres verdier i egenskapsinnstillingene dine.
- Kontakter: E-post. Du kan også inkludere fornavn og etternavn somgrunnleggende identifikasjonsinformasjon.
- Bedrifter: minst én av egenskapene «Navn » eller «Bedriftsdomenenavn».
Merk: Egenskapen «Bedriftsdomenenavn» godtar kun verdier opp til toppdomenet (f.eks. .com, .edu). Verdier med strenger etter dette (f.eks. .edu/home) blir automatisk fjernet 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 avtalestadiumet må være et gyldig stadium i den aktuelle pipelinen.
- Saker: Hvis du oppretter nye saker, gjelder dette «Sakens navn», «Pipeline» og «Sakens status».
- 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, skal du oppgi post-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 post-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-postretning.
- Møter:Møtebeskrivelse, Møtets starttid og Møtets sluttid. 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- og klokkeslett-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å duplik
ater
For å oppdatere eksisterende poster og unngå duplikater 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 filens kolonneoverskrifter slik at ID-en samsvarer med riktig objekt (f.eks. én kolonne kalt «Post-ID – Kontakter» og en annen kalt «Post-ID – Bedrifter»).
Merk:Følgende gjelder hvis e-postadresse eller bedriftsdomenenavn er inkludert i filen din:
- Hvis du bruker en egendefinert egenskap med unike verdier for å fjerne duplikater blant 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 sammen poster
Importer tilknytninger i én fil
I én fil kan du knytte sammen 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 sammen.
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 av dem til den samme posten.

Ved import av flere objekter fra én fil ved bruk av «Opprett og oppdater [poster]» vil HubSpot behandle identiske data for et objekt på tvers av rader som én post, selv om det ikke er oppgitt noen unik identifikator for det objektet. Hvis objektdataene avviker mellom radene, vil separate poster opprettes eller oppdateres. Denne funksjonen gjelder ikke for import som kun omfatter «Opprett nye [poster]» eller «Oppdater eksisterende [poster] ».
Hvis for eksempel to rader inneholder forskjellige kontakter knyttet til en avtale med navnet «Q4 Deal», og alle importerte avtaledata er identiske, vil HubSpot opprette én «Q4 Deal» og knytte den til begge kontaktene. Hvis en avtaleegenskap avviker mellom radene, vil HubSpot opprette to separate avtaler.

Siden avtaledataene er identiske i begge radene, oppretter importen én avtale knyttet til begge kontaktene.
Hvis du importerer tilknytninger mellom samme objekt, gjelder 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 på eksempelfilene for mer hjelp til å importere og knytte sammen poster.
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 avkrysningsrute 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 finnes i HubSpot før importen. Du kan for eksempel importere en ny kontakt og knytte den til en eksisterende kontakt, men dukan ikkeimportere for å opprette og knytte sammen to nye kontakter.
- Når du knytter sammen eksisterende kontakter/bedrifter, kan du bare bruke den primæree-postadressen/bedriftsdomenet som unik identifikator. Sekundære e-postadresser eller domener støttes ikke.
- Hvis du knytter flere poster til én post, må du skille de unike identifikatorverdiene med 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-postadressenederes som unik identifikator. Sookie er en eksisterende kontakt som knyttes til to eksisterende kontakter med samme etikett. I den første raden er tilknytningsetiketten del av et etikettpar, noe som betyr at når importen er fullført, vil den tilknyttede posten ha etiketten«Parent», mens Roryvil ha den tilhørende etiketten«Child».
Foreldre-/barn-tilknytninger
For å opprette tilknytninger mellom morselskaper og datterselskaper via import, kan du lese mer om import av datterselskaper.
Tilpassede tilknytningsetiketter
Abonnement påkrevd Det kreves et Professional- eller Enterprise-abonnement for å bruke egendefinerte tilknytningsetiketter.
For å importere tilknytningsetiketter må du inkludere en kolonne for «Tilknytningsetikett». Denne kolonnen bør bare legges til hvis du ønsker å 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 selskapskobling som primær, må du oppgi verdien «Primær» i kolonnen «Koblingsetikett»for den aktuelle raden.
- For å angi flere etiketter som beskriver forholdet mellom to poster, kan du inkludere flere verdier for tilknytningsetiketter i én celle, atskilt med semikolon (f.eks. «Sjef; Faktureringskontakt»).
- Hvis du importerer tilknytningsetiketter i en import med flere filer, må du inkludere kolonnen «Tilknytningsetikett» og en unik identifikator for objektet du knytter til, i samme fil.
- Hvis du importererparvise tilknytningsetiketter:
- 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 legges til underimportprosessen eller som er 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 ønsker å se flere eksempler med tilleggsegenskaper, kan du lese denne artikkelen med eksempelfiler.
Neste trinn
Nå som importfilen din er ferdig, følger du de aktuelle importinstruksjonene:
