Content mapping

Import site and OneDrive matches from CSV

Use the project template to map many source items without selecting each destination manually.

Quick answer

Download the mapping template, keep the source identifiers intact, fill the destination columns, and review the imported matches.

Your next step

Use destination URLs wherever possible; exact names are accepted only when they identify a unique item.

Import the template

  1. Complete both tenant scans, then select Download mapping template in the matching area.
  2. Open the downloaded CSV in Excel or another editor. Preserve the source values and column headings.
  3. Fill Destination URL or Destination name for the source items you want to match.
  4. Optionally set Include in restore plan to yes or no. Save as CSV.
  5. Choose Import mapping CSV, inspect the resolved matches, and save the reviewed set.

Template columns

ColumnHow to use it
Source name / Source URLIdentify the scanned source. Keep the template values unchanged.
Destination name / Destination URLIdentify an item from the destination scan. Prefer the URL when names may repeat.
Include in restore planUse yes or no to choose whether the matched item is included.
Source name,Source URL,Destination name,Destination URL,Include in restore plan
Finance,https://source.example.com/sites/Finance,Finance,https://destination.example.com/sites/Finance,yes

Fix import errors

  • A blank destination can be left for a later partial mapping.
  • A populated row must resolve to an unambiguous source and destination in this project.
  • Remove duplicate source rows and correct invalid Include values.
  • If Excel altered a URL or delimiter, restore the template's headings and save as a proper comma-separated CSV.
  • Importing site matches is different from importing people/group decisions. Use the template from the screen you are working on.

Continue with the next relevant guide.

Need help with your project?

Send the exact error and your project, batch, or run reference so we can investigate.

Get support