I have 2 farms sharepoint on-premises 2013 & sharepoint online. where we use to have a license for a third part migration tool, and we have migrated around 70% of the sites, but still the remaining sites require a lot of redevelopment so we keep them for future migration. and as most of the site collections use a term set, so i have migrate this term set, so now we have 2 identical term sets (on-premises & on-line).

where the terms have the same GUID and label, and other settings.. but today i want to add a new term, so i add it to our on-premises farm, but now i want to migrate or to recreate this term inside the online term set, where i want the online term to have the same GUID & label as the source on-premises term, so can i do so using PnP? i need the term to have the same GUID, as when we migrate the reaming sites, the metadata columns will be linked using the term GUID and not the term label.

2 Answers 2


I am afraid that we cannot keep the same GUID of the terms as the on -premise term when creating terms in SharePoint online.

We can download a copy of the import file, edit the import file by using your term set values and import the terms from the csv file in SharePoint online.

For more detailed information, refer to the article below.

Import term sets.

  • ok thanks for the reply.. i am already aware of the import/export, but seems these will work on the term set level.. now as i mentioned i already had migrated the term sets and all its terms,,, but now i need to migrate a single term inside existing term set.. also i am not sure how the migration tool has actually migrated the terms and preserve their GUIDs.. so this means that there must be a way to preserve the GUIDs.. is this correct?
    – John John
    Commented Apr 12, 2019 at 12:02
  • i found this link docs.microsoft.com/en-us/powershell/module/sharepoint-pnp/… which mentioned that we can not create term an supply the GUID for it...
    – John John
    Commented Apr 12, 2019 at 12:54
  • We can create the term but we cannot keep the same GUID for the term in SharePoint online.
    – Amy_MSFT
    Commented Apr 18, 2019 at 9:42
  • 1
    i do not think your point is 100% correct as using this command New-PnPTerm -Name "Active IT" -TermSet "T Group" -TermGroup "Customers" -Id "53385e78-e4c3-4f26-baac-bf7c832ec7d2" -Lcid "1033" i am able to create the term with the same GUID !!!
    – John John
    Commented Apr 18, 2019 at 12:20
  • It is very happy that the issue is resolved.
    – Amy_MSFT
    Commented Apr 19, 2019 at 1:39

I would suggest you use Hybrid Taxonomy, which will replicate your term store with SharePoint Online. The GUIDs and names will be identical.

  • i do not want to over complicate the issue, as i already have 2 copies of the term sets one inside online and the other inside on-premises.. so there is not any manual/simpler appraoch to copy a single term from on-premises to on-line?
    – John John
    Commented Apr 12, 2019 at 12:25
  • You took the hard approach. The easiest approach is to use hybrid Taxonomy which copies up the entire Term Set and Terms with the same ID, then pushes them back down to on-prem.
    – user6024
    Commented Apr 15, 2019 at 21:33
  • i might consider the approach you are proposing if i am building the online term sets from scratch.. but in my case i already have terms sets migrated from on-premises to online.. and now i need to migrate a single term only...
    – John John
    Commented Apr 16, 2019 at 2:12
  • Well, the approach I outlined is when you come from on-prem and need ot duplicate your taxonomy in SPO. But yeah, you're otherwise out of luck.
    – user6024
    Commented Apr 16, 2019 at 2:23
  • not really out of luck,, as using this command New-PnPTerm -Name "Active IT" -TermSet "T Group" -TermGroup "Customers" -Id "53385e78-e4c3-4f26-baac-bf7c832ec7d2" -Lcid "1033" i am able to create an online term which have the same GUID and name as the on-premises one... so i am able to migrate single terms using this command,,, and this is what i was searching for !!!
    – John John
    Commented Apr 16, 2019 at 11:03

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.