Migrating to Stoplight Platform

Your source for everything you need to know about migrating to Stoplight Platform™

https://d33wubrfki0l68.cloudfront.net/f29365e36d7b12872f87c487c8e0d62367eb882c/0fd46/images/workspaces/migrations-hero.svg
          
      

Deprecation of Classic and NEXT


We thank you from the bottom of our hearts for being a longtime user of Stoplight. For those of you who have been here with us since our Stoplight Classic and Stoplight NEXT days, we appreciate you immensely! As the API industry evolves, we want our product offerings to do the same. Please note legacy systems are being deprecated on December 31, 2021. This page will be your source for everything you need to know about migrating to Stoplight Platform™, with additional resources to come. Scroll down for instructions on migrating from Classic or NEXT to Stoplight Platform. For questions, please email [email protected].
    
      

Stoplight Platform Benefits

Build Better

Quickly and effectively design APIs with fast, intuitive no-code and low-code builders and collaborative tools.

https://d33wubrfki0l68.cloudfront.net/9ffa1663551d6f8a506617798a5ce9e256656a6d/6388d/images/design/designataglance.png

More Than Documentation

Design first with mocks, OpenAPI v3.0 & v3.1, JSON Schema, and reusable components, all in the cloud.

https://d33wubrfki0l68.cloudfront.net/4e69d8ce71d996717e47f6c1ab967bc72e2edeb7/c05c8/images/mocking/feedback.svg

Save Time

Create, store, and get complete visibility into your available API assets. Cut out unnecessary iteration.

https://d33wubrfki0l68.cloudfront.net/cb4577f91c604a75298ecfddd517bb90ee843eb2/68075/images/visibility/star.svg

Design Your Way

Leverage your existing workflows through integrations with GitHub, GitLab, Bitbucket, and more.

https://d33wubrfki0l68.cloudfront.net/5763338d7fdd12d3003d61a32cf00ea2e105f053/cebc0/images/design/preview.svg

Own Your APIs

Use your own chosen version control system. Stoplight does not hold your API designs and articles hostage.

https://d33wubrfki0l68.cloudfront.net/94b13f5ef98575fe11010167507e27adb84e4ba6/15371/images/integrations/ownyourapis.png

Design at a Glance

Visualize your dependencies, avoid breaking changes, plan versions proactively, and reduce the clutter.

https://d33wubrfki0l68.cloudfront.net/e46b7d5425ce834ad7e3745bba1d4eb7d3516db7/711e3/images/visibility/explorervis.png

Build Smarter

Scale-up design-first practices across your entire organization. Design high-quality APIs with stakeholder involvement at the beginning of your project, saving your company countless hours and technical debt.

https://d33wubrfki0l68.cloudfront.net/016a6aa9ce9aa040fffd315343be7b47c1c37fa0/f1491/images/workspaces/invites.png
    
      
Changes to Expect
Now that you know more about the benefits of Stoplight Platform, there are some changes to be aware of that impact your migration experience.
Hubs

NEXT allows for multiple Hubs per project. We will only be able to move and transform one Hub per project with our upcoming migration tooling - we’ll pick the largest one if there are multiple.

Scenarios

We will not be moving Scenarios over; Platform does not support Scenarios.

Custom Docs Features

Certain docs features like custom CSS, custom JS, custom landing pages, and custom domains cannot be moved over. We will be sharing documentation about how to perform custom work with an Elements Dev Portal soon.

Account Ownership

At the moment we are not planning to move other user accounts or ownership information over to Platform - all of the migrated projects will be owned by the user that initiated the transfer with our upcoming migration tool, and this user will be the only member.

Teams

We are planning to release a new Groups functionality in Platform to replace Teams. Learn more about this feature on our roadmap and stay tuned for more information.

Discussions

We don’t have discussions yet, so NEXT Discussions cannot be migrated. Learn more about a possible replacement feature for Platform on our roadmap and stay tuned for more information.

    

Getting Started

Our goal is to make migration smooth and efficient for all. For those of you who have data and projects to transfer to the new platform, we are here to help. The Administrator of your Stoplight Platform account will need to handle this process. Anyone can take the first step in getting started by creating a workspace in Stoplight Platform.

Data Transfer

After you’ve set up a new account on Stoplight Platform, as needed, the Administrator of your Stoplight Platform account can begin the process of transferring data. You can find the links to migration tooling for Classic and NEXT accounts below. We will be providing you regular updates during the depreciation period to ensure you have what you need to get you and your team transitioned. Thanks for being a part of the Stoplight community!
      

Migrating From Classic to Stoplight Platform

Are you using Stoplight Classic? Great news! We’ve got the “easy button” ready for you to migrate to Stoplight Platform. Check out the Classic migration docs to learn how. Reach out to [email protected] if you need further assistance.

Migrating from Classic to Platform

Migrating From Next to Stoplight Platform

Are you using Stoplight NEXT? Great news! We’ve got the “easy button” ready for you to migrate to Stoplight Platform. Check out the NEXT migration docs to learn how. Reach out to [email protected] if you need further assistance.

Migrating from Next to Platform