Sist oppdatert: 10 desember 2025
Før du importerer data til HubSpot, må du kontrollere at filene dine oppfyller kravene til format og tekniske begrensninger. Noen begrensninger er avhengige av abonnementet. Finn ut hvilke filtyper som støttes, hvordan du strukturerer og formaterer egenskapsverdier, og hvor mange rader og filer du kan importere i en gitt periode.
Gå gjennom hvordan importverktøyet fungerer, og bruk eksempelfiler eller genererte eksempelfiler til å forberede dataene dine. Hvis filen din er klar, kan du lære hvordan du importerer den.
Tekniske krav og begrensninger
Alle filer som importeres til HubSpot må:- Være en .csv-, .xlsx- eller .xls-fil.
- Ha bare ett ark.
- Inkludere 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 tilpasset egenskap før importen. Lær mer om egenskapskrav.
- Inneholde mindre enn 1000 kolonner.
- Være UTF-8-kodet hvis det inneholder tegn fra andre språk.
- Hvis du importerer en Excel-fil:
- Inneholder data som holder seg under Excel-regnearkets og -arbeidsbokens maksimumsgrenser.
- Inneholde celler i tallformat når du importerer egenskaper for dato- og tidspicker.
Det er ytterligere tekniske begrensninger for importverktøyet, avhengig av HubSpot-abonnementet ditt. Disse begrensningene inkluderer størrelsen og radbegrensningene for 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.
- 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.
- Hvis kontoen din har et Smart CRM- eller 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-en, kan du importere opptil 80 000 000 rader per dag.
Disse begrensningene gjelder for en rullerende 24-timers periode og tilbakestilles ikke på et bestemt tidspunkt på dagen. Lær mer omHubSpot-abonnementetdittog dets begrensninger.
Formatering av verdier
For hver rad i importfilen kan du legge til verdier for egenskapskolonnene. Formateringen av en verdi avhenger av egenskapsfeltetypen og målet med importen.
Formater verdier basert på egenskapsfeltetype
Avhengig av egenskapsfeltetypen er det spesifikke formateringskrav:
| Felt | Krav |
| Datovælger Dato- og tidvelger |
Måneder kan være et tall, tre bokstaver eller et fullstendig navn (10, OKT, okt, OKTOBER, oktober), å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 tidspicker |
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 tiden til midnatt som standard. |
| Varighet |
For egenskaper som inneholder en varighet, for eksempel egenskapen Samtalens varighet, må verdiene være formatert 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 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 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. Lær mer om import av flere avkrysningsboksverdier. |
| Tall |
Formater verdien basert på typen tallegenskap som er opprettet:
|
| Enkelt avkryssingsfelt |
Opprett en kolonne for feltet med enkelt avkryssingsboks og angi verdien på hver linje til TrueellerYesfor å vise Yes eller avkrysset i HubSpot, ellerFalseellerNofor å vise No eller ikke avkrysset i HubSpot. |
| Termegenskaper |
Linjeelementegenskapen Term bør legges til i ISO-8601-periodeformater på PnYnMnD eller PnW. For eksempel P12M eller P24M for årlige perioder. Hvis feltet er 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) |
For å tilordne 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 ekstra e-postadresse/et ekstra domene 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 være 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 manuelt redigere verdiene eller bruke arbeidsflyt-handlingen Rediger poster .Avtalekollaboratører
Hvis du legger til samarbeidspartnere til en avtale via import, må du inkludere en avtalekollaboratør-overskrift. For hver celle må du inkludere to eller flere brukere, atskilt med semikolon (f.eks. user1@example.com;user2@example.com).Produktperiode og faktureringsfrekvens
Hvis du importerer en verdien for egenskapen Term, kan du formatere verdien i kolonnen Term 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 faktureringsfrekvens-egenskapsverdi, bruker du månedlig, årlig eller kvartalsvis hvis produktet har en gjentakende pris. La cellen være tom hvis produktet har en engangspris.
Nødvendige egenskaper
Avhengig av hvilke objekter eller aktiviteter du importerer, er følgende egenskaper nødvendige 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, firmanavn).
Selv omdet ikke er påkrevd, kan du importere flere egenskaper for hvert objekt, inkludert tilpassede og standardegenskaper. Se standardegenskapene for kontakter, selskaper, avtaler, billetter, samtaler, e-poster, møter, notater og oppgaver. Du kan også se alle egenskaper og verdiene deres i egenskapsinnstillingene.
- Kontakter: minst ett av fornavn, etternavn eller e-postadresse.
- Bedrifter: minst ett av navn eller bedriftsdomenenavn.
Merk: Egenskapen for bedriftsdomenenavn godtar bare verdier opp til toppdomenet (f.eks. .com, .edu). Verdier med strenger etter seg (f.eks. .edu/home) blir automatisk fjernet når du importerer.
- Avtaler: hvis du oppretter nye avtaler,avtalenavn, pipeline og avtalestadium.
- Billetter: Hvis du oppretter nye billetter, billettnavn, pipeline og billettstatus.
- Avtaler: Avtalestart. Avtalestarten skal formateres som endato-tid-egenskap.
- Kurs: Kursnavn.
- Oppføringer: Navn.
- Tjenester: Navn, pipeline og pipeline-fase.
- Produkter: Hvis du oppdaterer produkter, oppførings-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 [valutakode] (f.eks. pris USD) og navn.
- Bestillinger: Navn, pipeline og pipeline-fase.
- Handlekurver: Navn.
- Linjeposter: Navn, antall, pris ogtilknyttede avtalers ID-nummer eller avtalenavn. Inkluder produktets produkt-ID hvis du også knytter linjeposten til et produkt, som vil bli tilordnet som en linjepostegenskap under importen.
Merk: Når du importerer linjeposter med avtaler, oppdateres ikke avtaleverdien under importen. For å oppdatere den tilknyttede avtaleverdien kan du redigere linjepostene manuelt eller knytte linjepostene til en avtale i HubSpot.
- Samtaler: Samtale-notater. Når du importerer nye samtaler, anbefales det også å inkludere Aktivitetsdato.
- E-post: E-posttekstog e-postretning.
- Møter:Møtebeskrivelse, møtestarttid og møtesluttid. Når du importerer nye møter, anbefales det også å inkludere Aktivitetsdato. Starttidspunkt, sluttidspunkt og aktivitetsdato bør formateres som dato- og tidspesifikasjoner.
- Notater: Notattekst.
- Oppgaver:Oppgavetittelogforfallsdato. Forfallsdatoen bør formateres som en dato-tid-egenskap.
Merk: Selv om det ikke er obligatorisk, 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, blir verdiene for aktivitetsdato automatisk satt til dato og klokkeslett for importen.
Krav for å oppdatere eksisterende poster eller unngå duplikater
For å oppdatere eksisterende poster og unngå dupliserte poster, må filene dine inneholde en unik identifikatoregenskap for hvert objekt. For alle objekter kan du eksportere eksisterende poster og bruke post-ID som en 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 tilpasset unik verdi-egenskap for å deduplisere kontakter, vil e-post -egenskapen fortsatt kreve unike verdier.
- Hvis du bruker en tilpasset unik verdi-egenskap for å deduplisere selskaper, vil egenskapen Selskapsdomenenavn 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 du importerer, eller bruke Selskapsdomenenavn som din unike 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 imidlertid 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 sammen
Importer tilknytninger i én fil
I én fil kan du knytte to eller flere poster sammen per rad. Inkluder 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 for et annet objekt, inkluderer du postens unike identifikator i flere rader for hver post du vil 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 Record ID) og Selskapsdomenenavn (eller Record ID) for hvert selskap.
Merk: Hvis du ikke inkluderer unike identifikatorer (f.eks. E-post, Firmanavn, Post-ID), vil importen opprette dupliserte poster i stedet for å knytte hver til samme post.
Hvis du importerer tilknytninger til samme objekt, er det ytterligere krav.
Importer tilknytninger i to filer
For å knytte poster fra to objekter i to filer sammen, bruker du en felles kolonne til å koble sammen postene i hver fil. Du kan se eksemplene på filer for mer hjelp til å importere og knytte sammen poster.
Samme objektsammenkoblinger
Du kan importere én fil for å knytte poster av samme objekt i bulk. Under importprosessen må du merke av i en boks for å inkludere samme objektsammenkoblinger.
Når du konfigurerer 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/selskapsdomenet 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 identifikasjonsverdier 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 unike etiketter til eksisterende kontakter, 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 etikettenForelder og Roryvil ha den parede etikettenBarn.
Foreldre/barn-tilknytninger
For å opprette tilknytninger mellom barn- og morselskaper via import, kan du lære mer om import av barnselskaper.
Tilpassede tilknytningsetiketter
Abonnement påkrevd Du må ha et Professional- eller Enterprise-abonnement for å kunne 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 bedriftsassosiasjon 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 assosiasjonsetikettverdier i én celle, atskilt med semikolon (f.eks. Manager; Faktureringskontakt).
- Hvis du importerer tilknytningsetiketter i en import av flere filer, må du inkludere kolonnen Tilknytningsetikett og en unik identifikator for objektet du tilknytter i samme fil.
- Hvis du importererparvise etiketter:
- For kryssassosiasjoner mellom objekter må du bare inkludere én av etikettene i kolonnen Assosiasjonsetikett. Etikettene vil bli tilordnet riktig objekt under importprosessen.
- For tilknytninger mellom 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.
