Raycast API
Community
Search…
Raycast API
Introduction
Links
Community
GitHub
Store
Extension Icon Template
Basics
Getting Started
Create Your First Extension
Contribute to an Extension
Prepare an Extension for Store
Publish an Extension
Debug an Extension
Install an Extension
Teams (Beta)
Getting Started
Publish a Private Extension
Collaborate on Private Extensions
Examples
Doppler Share Secrets
Hacker News
Todo List
Spotify Controls
Information
Best Practices
CLI
File Structure
Lifecycle
Manifest
Versioning
Security
Terminology
API Reference
Clipboard
Environment
Feedback
Keyboard
OAuth
Preferences
Storage
User Interface
Utilities
Window & Search Bar
Changelog
Migration
v1.28.0
v1.31.0
FAQ
Powered By GitBook
Migration
This section contains guides to help migrate your extension to a newer version of the API.

How to automatically migrate your extensions

Whenever possible, we provide tools to automate the migration to a newer version of the API using codemods.
To run the codemods, run the following command in your extension directory:
1
npx ray migrate
Copied!
or
1
npx @raycast/migration .
Copied!
It will detect the version of the API you were previously using and apply all the migrations that have been available since.
After running it, do go through the updated files and make sure nothing is broken - there are always edge cases.
Previous
Changelog
Next
v1.28.0
Last modified 3d ago
Copy link
Edit on GitHub
Contents
How to automatically migrate your extensions