# Initialize Sanity and install the migration toolkit https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/initialize-sanity-migration-toolkit Scaffold a Sanity project, add your schemas, and install the migration toolkit so AI agents can work with your content. --- ## Navigation **Course:** [Migrating from Webflow to Sanity](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity) · [View as markdown](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity.md) **Previous:** [Export from Webflow and connect the Data API](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/export-webflow-connect-api) · **Next:** [Map collections to Sanity document types](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/map-collections-to-schemas) --- ## Course Contents 1. [Introduction](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/introduction-to-webflow-migration) 2. [Audit your Webflow content](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/audit-webflow-content) 3. [Recognize Webflow's content modeling patterns](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/recognize-content-modeling-patterns) 4. [Export from Webflow and connect the Data API](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/export-webflow-connect-api) 5. **Initialize Sanity and install the migration toolkit** *(current)* 6. [Map collections to Sanity document types](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/map-collections-to-schemas) 7. [Build a page builder with a sections array](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/page-builder-sections-array) 8. [Model custom-template pages as singletons](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/custom-template-singletons) 9. [Model navigation in Sanity](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/model-navigation) 10. [Create a siteSettings singleton](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/site-settings-singleton) 11. [Handle internal links in Portable Text](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/internal-links-portable-text) 12. [Fetch your collection items from the API](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/fetch-collection-items-api) 13. [Run the asset pre-upload pass](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/asset-pre-upload) 14. [Resolve reference fields from API data](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/resolve-reference-fields) 15. [Convert rich text to Portable Text](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/convert-rich-text-portable-text) 16. [Extract static page content using the page DOM API](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/extract-static-page-content) 17. [Import content with the two-pass pattern](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/two-pass-import) 18. [Validate your import in Studio](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/validate-import-studio) 19. [Set up forms, redirects, and sitemap](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/forms-redirects-sitemap) 20. [Set up draft mode and visual preview](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/draft-mode-visual-preview) 21. [Validate your import without a frontend](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/validate-migration) 22. [Launch checklist and DNS transfer](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/launch-checklist-dns) 23. [AI prompt library and resources](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity/appendix-prompt-library-resources) --- ### Initialize your Sanity project From the root of your project: ```bash pnpm create sanity@latest ``` Follow the prompts. Choose a new project, create a staging dataset, and select TypeScript. When asked for the project output path, type `./sanity`. The CLI defaults to a folder named after your project, but you want it at `/sanity/` relative to your migration root, and the `./` prefix is required — typing `sanity` alone will fail. This scaffolds `/sanity/` with a Studio configuration, a `schemaTypes/` folder, and a dev server. Once it completes, fill in the Sanity credentials in your `.env` file. Your project ID shows up in the terminal output, and also at [sanity.io/manage](https://sanity.io/manage). For the token, go to sanity.io/manage → your project → API → Tokens and create one with Editor permissions: ```bash:.env # .env — add these after running pnpm create sanity@latest SANITY_PROJECT_ID=your_project_id SANITY_DATASET=staging SANITY_TOKEN=your_editor_token ``` ### Verify the dataset exists before running any imports The Sanity CLI scaffolds the project but doesn't always create the dataset you named — type `staging` but the project only has `production`, and the first import fails with "dataset not found." Confirm it before continuing: ```bash npx sanity datasets list --project ``` If staging isn't in the list, create it: ```bash npx sanity dataset create staging ``` ### Install the migration toolkit From the project root (not inside `/sanity/`): ```bash pnpm dlx skills add sanity-io/agent-toolkit --skill sanity-migration ``` This gives AI agents in your project access to Sanity's mutation API, GROQ querying, and asset upload, the tools the migration scripts use. ### Run Studio locally ```bash cd sanity && pnpm dev ``` Open `localhost:3333`. The sidebar is empty at this point since you haven't added any schemas yet and that's expected. What you're confirming here is that Studio loads without errors. Fix any TypeScript or compilation error before moving on. Next, you’ll design your content model using the API data you just fetched. --- ## Related Resources - [Full course as markdown](https://www.sanity.io/learn/course/migrating-content-from-webflow-to-sanity.md) - [All courses and lessons](https://www.sanity.io/learn/sitemap.md) - [Complete content for LLMs](https://www.sanity.io/learn/llms-full.txt) ## Submitting Feedback If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback: POST https://www.sanity.io/learn/resource/feedback ```json { "path": "/learn/course/migrating-content-from-webflow-to-sanity/initialize-sanity-migration-toolkit.md", "feedback": "Description of the issue" } ``` Only submit feedback when you have something specific and actionable to report.