Skip to main content

​
Final Review

Before starting the import, review your configuration:
1

Check the preview

MigrateKit shows sample documents in Sanity format:
  • Review 3-5 sample documents
  • Check Portable Text rendering
  • Verify image references
  • Confirm field mappings look correct
2

Review import summary

Confirm:
  • Total documents to import
  • Number of assets to upload
  • Target Sanity project and dataset
  • Any validation warnings
3

Check for warnings

Address any yellow warning indicators:
  • Missing recommended fields
  • Potential data type issues
  • Large file sizes
Address errors before importingRed error messages will block the import. Fix these issues before proceeding:
  • Required fields with missing data
  • Invalid field types
  • Malformed HTML
  • Connection issues
See Troubleshooting for help.

​
Execute the Import

1

Click 'Import to Sanity'

Start the migration process
All documents are created as drafts (with drafts. prefix). Your published content stays safe.
2

Monitor progress

Watch real-time updates:
  • Documents created: XX / YY
  • Assets uploaded: XX / YY
  • Processing time estimate
  • Current operation status
3

Review results

When complete, you’ll see:
  • Total documents imported
  • Assets uploaded vs. reused
  • Any warnings or errors
  • Link to view drafts in Sanity

​
Understanding Import Status

Green checkmark - Document imported successfullyThe document is now a draft in your Sanity project, ready for review.

​
Asset Upload Details

MigrateKit handles image and file uploads automatically:

​
How Assets Are Processed

1

Download from Webflow

Fetches assets from Webflow CDN URLs in your CSV
2

Check for duplicates

Uses image hash to detect if asset already exists in your Sanity project
3

Upload or reuse

  • Upload: New assets are uploaded to Sanity
  • Reuse: Existing assets are referenced (saves time and space)
4

Create references

Links uploaded assets to the appropriate document fields

​
Asset Upload Statuses

  • Uploaded - New asset uploaded to Sanity
  • Reused - Existing asset found and referenced
  • Failed - Upload failed (network error, quota exceeded, invalid URL)
Failed asset uploads don’t block the document import. Documents import with missing image references, and you can manually upload assets later.

​
Verify in Sanity Studio

1

Open Sanity Studio

Navigate to your Sanity Studio (usually yourproject.sanity.studio)
2

View drafts

Click the Drafts filter to see imported documents
3

Check random samples

Review several documents for:
  • Content accuracy - Text matches Webflow source
  • Formatting - Portable Text looks correct (headings, lists, bold/italic)
  • Images - All images loaded and display properly
  • Links - Links are clickable and point to correct URLs
4

Test Portable Text

Open documents with rich text content:
  • Headings render at correct levels
  • Paragraph spacing looks natural
  • Lists are formatted properly
  • Bold, italic, underline preserved

​
Common Post-Import Tasks

Webflow embeds import as code blocks for safety. Review and replace with Sanity-compatible alternatives:
  • YouTube embeds → Sanity YouTube plugin
  • Custom scripts → Sanity-safe implementations
  • Iframes → Appropriate Sanity component
Learn more: HTML Conversion
Since reference fields aren’t migrated automatically:
  1. Note which documents should reference others
  2. Manually link references in Sanity Studio
  3. Consider creating a checklist before migration
Fine-tune Portable Text if needed:
  • Adjust heading levels
  • Add spacing between sections
  • Clean up formatting quirks from HTML conversion
Consider:
  • Adding alt text for accessibility
  • Cropping or resizing images
  • Adding captions or credits

​
Publish Your Content

Once you’ve verified everything looks correct:
1

Select documents to publish

In Sanity Studio, choose documents from the drafts section
2

Publish individually

Click Publish on each documentOr:
3

Bulk publish

Select multiple documents and publish in batch
Start with a small batch to ensure everything works before publishing all content
Published documents are now live in your Sanity dataset!

​
If Something Went Wrong

Check the import report for specific errors:
  • Fix issues in original CSV
  • Adjust field mappings if needed
  • Re-upload and import just the failed rows
See Troubleshooting: Import Errors
Common causes:
  • Complex HTML structures MigrateKit couldn’t convert
  • Nested formatting that doesn’t map to Portable Text
  • Custom Webflow elements
Fix: Manually edit in Sanity Studio or see HTML Conversion Issues
Check:
  • Asset upload report for failures
  • Original Webflow CSV has valid image URLs
  • Sanity asset quota not exceeded
You can manually upload missing images in Sanity Studio.
To start over:
  1. Delete drafts in Sanity Studio (select all → delete)
  2. Adjust your field mappings in MigrateKit
  3. Re-import the CSV
MigrateKit uses Item ID to update existing documents instead of creating duplicates.