Create a scoped view

You use a scoped view to define the source data accessed for a scan. Scoped-view entries work even if the source data is changed. For example, Google Workspace Migrate can resolve the scoped view entry if a mail folder is renamed.

Tip: If you have a lot of data to scan, use scoped views to manage data. A scoped view allows you to divide the data into chunks, allowing you to scan in manageable phases.

Before you begin

Review Scoped view & mapping headers.

Step 1: Create a CSV file to add multiple entries

You can add multiple entries to a scoped view using a comma-separated values (CSV) file. Scoped-view CSV files must contain:

  • A header row specifying the object type. 
  • Rows under the header with locations for the specified types.

A scoped view can have multiple columns, each with a type-name header. If there's no value in a column, then that column is disregarded for the row. Make sure the character encoding of the CSV file is set to UTF-8. 

Step 2: Create a scoped view

  1. In the Google Workspace Migrate platform, click Connections. You might have to click Menu "" first. 
  2. Next to your connection, click Scoped views "".
  3. In the top-right corner, click Add "".
  4. Enter a name for your scoped view.
  5. Click Upload CSV file to upload a CSV file or drag a file to the box.
  6. Click Create.

Update & validate a scoped view

Expand all  |  Collapse all

Update a scoped view

As you add entries to a scoped view, Google Workspace Migrate validates the source locations.

  1. Point to your scoped view and click Entries "".
  2. Click Add ""and thenAdd entries manually
  3. Check the box next to the target locations. Click the Down arrow "" to expand your selection. 
  4. After you select all the locations, click Nextand thenAdd.
Delete a scoped view
  1. Point to your scoped view and click Entries "".
  2. Next to the entry you want to remove, check the box and click Delete "".
Check that your scoped view entries are valid
  1. Point to your scoped view and click Entries "".
  2. Next to the entry you want to validate, check the box and click Validate "".

A green check indicates that the entry is validated.

Next step

Verify the connection

Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.

Clear search
Close search
Google apps
Main menu
Search Help Center