Promote copies your sites as site collections to upgrade them. With the promote report you can review the status of all your items during that migration.
- Access your Promote report
- Understanding your Promote Summary
- View all details
Access your Promote report
When you launch Promote, you are immediately taken to the report. If you leave that screen, you can always return to the report in Tasks.
- Click Tasks on the bottom-left menu.
- Click Add filter to apply filters for Task type.
- Select the task to open that Promote report.
Understanding your Promote report summary
You see the site name before, and after the promote job.
You see the site address before, and after the promote job.
Shows if the original site is deleted or unmodified. This will depend on the option you selected in the promote options.
New Site Collection
See if there was any issues at a glance. If you have any issues, you can review them with the View all details button.
View all details
You can review the report details of your promote job. Click on View all details in the top right to open the details in the application.
Your promote details give you a detailed view of which items migrated successfully, and which items had warnings or errors associated to them when attempting to promote your site.
You can export your results as an Excel or CSV file by clicking the Export button and saving the file to your preferred location.
Understanding Warnings and Errors
When running promote on many sites, it is normal to see many warnings and errors as your results load.
When you get an indication to Show item-level filter option to display the details, click on Filter and check the Show Item-Level in the Options section to see details regarding errors or warnings on list items and documents. Learn more.
A warning indicates that your item type was successfully migrated to the destination but a modification needed to occur to get it there, or something needed to be left out. A common example is a list that migrates successfully without a source field, because that field is not supported in the destination environment.
When warnings occur, it is almost always because something is not supported between versions, and the best solution is to manually create a substitute in your destination environment.
An error indicates that the ShareGate migration tool was not able to migrate the item type to the destination. Errors can be complex, and always have associated error codes and articles to help you work through why the error occurred and indicate if there is a solution or workaround. Click the provided Help me solve this link to access the articles.