Sist oppdatert: 3 oktober 2025
Før du importerer data til HubSpot, bør du lese gjennom følgende begrensninger og krav. Du kan også få tilgang til eksempelfiler eller generere eksempelfiler for å komme i gang.
Hvis du vil lære mer om importverktøyet, kan du lese denne artikkelen. Hvis filen din er klar, kan du lære hvordan du importerer.
Tekniske krav og begrensninger
Alle filer som importeres til HubSpot må:- Være en .csv-, .xlsx- eller .xls-fil.
- Kun ha 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 bekrefte om det allerede finnes en standardegenskap som samsvarer med overskriften din, eller opprette en egendefinert egenskap før du importerer. Finn ut mer om krav til egenskaper.
- Inneholde mindre enn 1000 kolonner.
- Være UTF-8-kodet hvis fremmedspråklige tegn er inkludert.
- Hvis du importerer en Excel-fil:
- Inneholde data som holder seg under Excels maksimumsgrenser for regneark og arbeidsbøker.
- Inneholde celler i tallformat ved import av egenskaper for dato- og tidsvelger.
Det finnes flere tekniske begrensninger for importverktøyet, avhengig av HubSpot-abonnementet ditt. Disse begrensningene inkluderer størrelsen på og radbegrensningene for en importfil, samt hvor mange filer og rader du kan importere per dag.
- Hvis du kun bruker HubSpots gratis- eller Smart CRM Professional- eller Enterprise-verktøy , kan du gjøre det:
- Importere filer på opptil 20 MB.
- Fullføre opptil 50 importer per dag.
- Importere opptil 500 000 rader per dag. Hvis du importerer en fil som inneholder mer enn 500 000 rader, vil det ta flere dager å fullføre den.
- Hvis kontoen din har et Starter-, Professional- eller Enterprise-abonnement, kan du:
- Importere filer på opptil 512 MB.
- Fullfø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.
Disse grensene gjelder for en rullerende 24-timers periode og tilbakestilles ikke til et bestemt tidspunkt på dagen. Finn ut mer om HubSpot-abonnementet ditt og dets begrensninger.
Formatering av verdier
For hver rad i importfilen kan du legge til verdier for egenskapskolonnene. Formateringen av en verdi avhenger av egenskapsfelttypen og målet med importen.
Formater verdier basert på egenskapsfelttype
Avhengig av typen egenskapsfelt er det spesifikke formateringskrav:
| Felttype | Krav til formatering |
| Datovelger Dato- og klokkeslettvelger |
Måneder kan være et tall, tre bokstaver eller et fullt navn (10, OCT, Oct, OCTOBER, October), år kan være to eller fire sifre (2023, 23), og separatorer 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 vil de ikke bli importert. |
| Dato- og klokkeslettvelger |
Tidsstempler kan legges til 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 tekstnummerformat. Hvis du ikke inkluderer et tidsstempel, settes klokkeslettet til midnatt som standard. |
| Varighet |
For egenskaper som inneholder en varighet, for eksempel egenskapen Anropsvarighet, må verdiene formateres som et UNIX-tidsstempel i millisekunder. Finn ut 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 av egenskapens definerte alternativer. For HubSpots standard oppregningsegenskaper (f.eks. livssyklusstadium, bransje) må verdiene samsvare med den interne verdien eller etiketten på engelsk. |
| Fil |
Hvis du vil legge til eksisterende filer i en filegenskap, må du inkludere fil-ID-en som verdi. Du finner fil-ID-en i delen Generelt i filens detaljer. |
| Flere avmerkingsbokser |
Hvis du vil importere flere verdier, legger du til et semikolon mellom hver verdi uten mellomrom (verdi 1;verdi 2). Disse egenskapsalternativene må opprettes før importen. Hvis du vil legge til eller legge til verdier, legger du til et semikolon før den første verdien (;verdi 3;verdi 4). Dette vil legge til verdien i stedet for å overskrive den eksisterende egenskapsverdien. |
| Antall |
Formater verdien basert på hvilken type tallegenskap som er opprettet:
|
| Enkel avkrysningsboks |
Opprett en kolonne for enkelt avkrysningsfelt og sett verdien på hver linje til True eller Yes for å vises som Yes eller avkrysset i HubSpot eller False eller No for å vises som No eller ikke avkrysset i HubSpot. |
| Term-egenskaper |
Linjeelementegenskapen Term skal legges til i ISO-8601-periodeformatene PnYnMnD eller PnW. For eksempel P12M eller P24M for årlige terminer. Hvis den ikke fylles ut, vil standardvilkår bli angitt. |
| Tekst |
Hvis du har angitt valideringsregler, må de importerte verdiene følge reglene, ellers vil de ikke bli importert. |
| Bruker (eier) |
For å tilordne en eier til en post eller aktivitet under importen:
|
Ytterligere kontakt-e-postadresser eller bedriftsdomener
Hvis du importerer kontakter med mer enn én e-postadresse, kan du inkludere en kolonne med flere e-postadresser med deres sekundære e-postadresser. Hvis du importerer selskaper med mer enn ett domenenavn, inkluderer du en kolonne med flere domener med deres sekundære domener. Hvis du vil inkludere flere e-postadresser eller domener i en celle, skiller du verdiene med semikolon (f.eks. email@email. com; emailtwo@email.com).
Hvis du importerer for å opprette kontakter eller selskaper, kan du ikke angi en ny kontakts E-post eller et nytt selskaps Firmadomenenavn til en e-post eller et domene som er en eksisterende tilleggs-e-post/et eksisterende tilleggsdomene for en annen post.
Tomme celler
Importverktøyet ignorerer tomme celler i et regneark, så når du importerer nye eiendomsdata, må du la celler være tomme for poster uten en verdi for egenskapen. Hvis en eksisterende post allerede har en verdi for egenskapen i HubSpot, vil tomme cellerikke slette den eksisterende egenskapsverdien. Hvis du vil slette eksisterende egenskapsverdier i bulk, kan du redigere verdiene manuelt eller bruke arbeidsflythandlingenRediger poster .Avtale samarbeidspartnere
Hvis du legger til samarbeidspartnere i en avtale via import, må du inkludere en overskrift forsamarbeidspartnere i avtalen. For hver celle må du inkludere to eller flere brukere, atskilt med semikolon (f.eks. user1@example.com;user2@example.com).Produktbetegnelse og faktureringsfrekvenser
Hvis du importerer en Term-egenskapsverdi, kan du formatere verdien i Term-kolonnen 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 PXY der X er antall år (f.eks. P1Y, for en periode på 1 år).
Hvis du importerer en egenskapsverdi for faktureringsfrekvens, bruker du månedlig, årlig eller kvartalsvis hvis produktet har en tilbakevendende pristype. La cellen stå tom hvis produktet har en engangspris.
Nødvendige egenskaper
Avhengig av hvilke objekter eller aktiviteter du importerer, er følgende egenskaper påkrevd for å opprette poster, og de må inkluderes som kolonneoverskrifter i filene dine. Hvis du oppdaterer poster, må du inkludere en unik identifikator (f.eks. post-ID, e-post, selskapets domenenavn).
Selv omdet ikke er påkrevd, kan du importere flere egenskaper for hvert objekt, inkludert egendefinerte egenskaper og standardegenskaper. Se standardegenskapene for kontakter, selskaper, avtaler, billetter, samtaler, e-post, møter, notater og oppgaver. Du kan også vise alle egenskaper og verdiene deres i egenskapsinnstillingene.
- Kontakter: minst én av følgende: Fornavn, Etternavn eller E-post.
- Bedrifter: minst ett av Navn eller Bedriftens domenenavn.
Merk: Egenskapen Selskapets domenenavn godtar bare verdier opp til toppnivådomenet (f.eks. .com, .edu). Verdier med etterfølgende strenger (f.eks. .edu/home) blir automatisk fjernet når du importerer.
- Avtaler: Hvis du oppretter nye avtaler, avtalens navn, pipeline og avtalefase.
- Billetter: hvis du oppretter nye billetter, billettnavn, pipeline og billettstatus.
- Avtaler: Start for avtale. Avtalestart bør formateres som en dato og klokkeslett-egenskap.
- Kurs: Kursnavn: Navn på kurs.
- Oppføringer: Navn.
- Tjenester: Navn: Navn, Pipeline og Pipeline-stadium.
- 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 Pipeline-stadium.
- Handlekurver: Navn.
- Varelinjer: Navn, antall, pris og den tilknyttede avtalens Record ID eller avtalens navn. Ta med produktets produkt-ID hvis du også knytter varelinjen til et produkt, som vil bli tilordnet som en varelinjeegenskap under importen.
Merk: Når du importerer varelinjer med avtaler, oppdateres ikke avtalebeløpet under importen. Hvis du vil oppdatere det tilknyttede avtalebeløpet, kan du redigere varelinjene manuelt eller knytte varelinjene til en avtale i HubSpot.
- Samtaler: Anropsnotater. Når du importerer nye samtaler, anbefales det også å inkludere aktivitetsdato.
- E-poster: E-postens brødtekst og retning.
- Møter: Møtebeskrivelse, Møtets starttidspunkt og Møteslutttidspunkt. Når du importerer nye møter, anbefales det også å inkludere aktivitetsdato. Verdiene for starttidspunkt, sluttidspunkt og aktivitetsdato bør formateres som dato-tid-egenskaper.
- Notater: Notatets brødtekst.
- Oppgaver: Oppgavetittel og Forfallsdato . 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 å angi dato og klokkeslett for når en aktivitet fant sted. Hvis du ikke inkluderer denne egenskapen, blir aktivitetsdatoverdiene automatisk satt til datoen og klokkeslettet for importen.
Krav for å oppdatere eksisterende poster eller unngå duplikater
For å oppdatere eksisterende poster og unngå dupliserte poster må filene inneholde en unik identifikatoregenskap for hvert objekt. For alle objekter kan du eksportere eksisterende poster og bruke Record ID som enunik identifikator, eller bruke en egendefinert 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 Record ID-er, anbefales det å differensiere kolonneoverskriftene i filen for å matche ID-en med riktig objekt (f.eks. en kolonne som heter Record ID - Kontakter og en annen som heter Record ID - Bedrifter).
Merk: Følgende oppførsel gjelder hvis e-postadressen eller selskapets domenenavn er inkludert i filen:
- Hvis du bruker en egendefinert unik verdiegenskap for å deduplikere kontakter, vil e-postegenskapen fortsatt kreve unike verdier.
- Hvis du bruker en egendefinert unik verdiegenskap for å deduplikere selskaper, vil ikke egenskapen Firmadomenenavn kreve unike verdier. Dette betyr at du kan importere dupliserte selskapsdomener. Hvis du ikke vil ha flere selskaper med samme domene, bør du fjerne dupliserte domener fra filen før du importerer, 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 Record ID-kolonnen i filen, vil ikke den sekundære e-posten erstatte den primære e-posten. Hvis du derimot inkluderer både den sekundære e-postadressen og Record ID som kolonner i filen, vil den sekundære e-postadressen erstatte den primære e-postadressen.
Krav for å tilknytte poster
Importer assosiasjoner i én fil
I én fil kan du knytte to eller flere poster per rad. Inkluder informasjon om tilknyttede poster og/eller aktiviteter i samme rad, og inkluder en unik identifikator for hvert objekt. Hvis du vil knytte én post til flere aktiviteter eller poster for et annet objekt, må du inkludere postens unike identifikator i flere rader for hver post du vil knytte til.
Luke Danes er for eksempel daglig leder på Luke's Diner, men entreprenør på The Dragonfly Inn. Hvis du vil knytte ham til begge selskapene, må du inkludere to rader for Luke Danes med kolonnene E-post (eller Record ID) og Selskapets domenenavn (eller Record ID) for hvert selskap.
Merk: Hvis du ikke inkluderer unike identifikatorer (f.eks. e-post, selskapets domenenavn, Record ID), vil importen opprette dupliserte poster i stedet for å knytte dem til samme post.
Hvis du importerer samme objektassosiasjoner, er det flere krav.
Importer assosiasjoner i to filer
Hvis du vil knytte sammen poster for to objekter i to filer, bruker du en felles kolonne for å koble sammen postene i hver fil. Du kan se eksempelfilene for mer hjelp med å importere og knytte sammen poster.
Assosiasjoner for samme objekt
Du kan importere én fil for å knytte sammen poster med samme objekt i bulk. Under importprosessen må du merke av i en avmerkingsboks for å inkludere samme objektassosiasjoner.
Når du konfigurerer filen, må du inkludere informasjon om de tilknyttede postene i samme rad og inkludere en unik identifikator for hver post. Følgende tilleggskrav er spesifikke for import av samme objekt:
- Minst én post i et postpar må allerede finnes i HubSpot før du importerer. Du kan for eksempel importere en ny kontakt og knytte den til en eksisterende kontakt, men du kan ikke importere for å opprette og knytte til to nye kontakter.
- Når du knytter eksisterende kontakter/selskaper, kan du bare bruke den primære e-postadressen/selskapetsdomene som unik identifikator. Sekundære e-poster eller domener støttes ikke.
- Hvis du knytter flere poster til én post, må du skille postenes unike identifikatorverdier 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 med unike etiketter til eksisterende kontakter, med e-postverdiene deres 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 Rory vil ha den parede etiketten Child.
Foreldre/barn-assosiasjoner
Hvis du vil opprette assosiasjoner mellom barn og foreldre via import, kan du lese mer om import av barneselskaper.
Egendefinerte assosiasjonsetiketter
Abonnement påkrevd Det kreves et Professional- eller Enterprise-abonnement for å bruke egendefinerte assosiasjonsetiketter.
Hvis du vil importere assosiasjonsetiketter , må du inkludere en kolonne for assosiasjonsetikett . Denne kolonnen bør bare legges til hvis du vil legge til etiketter for å beskrive assosiasjoner. Hvis du ikke trenger å merke assosiasjoner, er ikke kolonnen nødvendig.
- Du må opprette assosiasjonsetikettene i HubSpot før du importerer.
- Hvis du vil angi en bedriftsassosiasjon som primær, legger du til verdien Primær i kolonnen Assosiasjonsetikett for den aktuelle raden.
- Hvis du vil angi flere etiketter for å beskrive forholdet mellom to poster, kan du inkludere flere verdier for assosiasjonsetiketter i én celle, atskilt med semikolon (f.eks. Manager; Faktureringskontakt).
- Hvis du importerer assosiasjonsetiketter i en import av flere filer, må du inkludere kolonnen for assosiasjonsetikett og en unik identifikator for objektet du assosierer, i samme fil.
- Hvis du importerer parvise etiketter:
- For assosiasjoner på tvers av objekter må du bare inkludere én av etikettene i kolonnen Assosiasjonsetikett. Etikettene vil bli tilordnet riktig objekt under importprosessen.
- For assosiasjoner til samme objekt vil posten i kolonnen Assosiert [unik identifikator] motta etiketten som ble lagt til i importprosessen eller som er inkludert i filens etikettkolonne. Den andre posten i raden vil motta den andre etiketten i paret.
Eksempel på filer
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 flere egenskaper, kan du se denne artikkelen med eksempelfiler.
