Scalar vs Stoplight

Last updated: September 2026

Stoplight is a design-first API platform: a visual OpenAPI editor, hosted documentation, style-guide linting, and mock servers, tied together with Git. It also gave the ecosystem three of its most widely used open-source tools, Spectral, Prism, and Elements. If you are choosing where to design and publish your APIs, Stoplight belongs on your list, and so do we.

This page is written by Scalar, so read it with that in mind, and with one more disclosure: several people on the Scalar team previously helped build Stoplight. We know the product well and we like a lot of it. Every claim we make about Stoplight links to its own pricing page, repositories, or public announcements. If we have something wrong, tell us and we will fix it.

One thing to know up front: SmartBear announced its acquisition of Stoplight on 22 August 2023. Stoplight's pricing page is live and plans are still sold, and we found no end-of-life announcement. SmartBear's newer platform is API Hub, and in October 2025 the APIs You Won't Hate newsletter wrote that "work on Stoplight appears to be slowing". That is an informed opinion, not an announcement, but if you are planning a multi-year commitment it is worth asking SmartBear for the roadmap in writing.

If you already know you are moving, the Stoplight migration guide has the step-by-step instructions.

At a glance

Where Stoplight is stronger

The visual designer. Stoplight's form-based OpenAPI designer lets people build a description without writing YAML. For product managers, technical writers, and designers who own API contracts but not code, that is a genuine advantage. Scalar's editor is closer to a code editor, with validation and completion. It is fast for developers and less guided for everyone else.

Governance at scale. Stoplight's Pro Team plan includes shared style guides, up to 20 teams, workspace groups, and LDAP/SAML SSO, all designed around governing many APIs across an organisation. Scalar supports Spectral-compatible rules, but Stoplight has spent years on the workflow around them.

It invented the tools everyone else uses. Spectral, Prism, and Elements are all Apache-2.0 and still actively published: the Spectral CLI released 6.16.3 in August 2026, Prism 5.16.0 in July, and Elements 9.0.25 in August. Scalar's rules extend Spectral's default spectral:oas ruleset. We owe these projects a lot.

More Git providers. Stoplight connects to GitHub, GitLab, Azure DevOps, and Bitbucket. Scalar's Git sync is GitHub; GitLab users publish from CI with the CLI.

Cheaper for very small teams. Stoplight Basic is $44/month billed annually for three users. If you need a hosted, private designer for one or two people and nothing else, that is less than Scalar Pro.

Stoplight vs Scalar

Both products cover the design-first loop: write the description, lint it, mock it, publish docs from it. The differences are in what is open, what comes after the docs, and how the platform is priced.

The documentation layer

Stoplight's hosted docs are part of the platform. If you want to embed docs in your own site, Stoplight Elements provides React and web components under Apache-2.0:

<elements-api
  apiDescriptionUrl="/openapi.yaml"
  router="hash"
  layout="sidebar"
/>

Scalar's API reference is MIT licensed and is the same renderer used on the hosted platform, not a separate open-source edition. You can self-host it on any plan, or with no plan at all, and mount it inside your application through 35+ framework integrations such as Express, FastAPI, NestJS, ASP.NET Core, and Spring Boot.

Every Scalar reference includes a full API client on each operation, with environments, OAuth 2.0 flows, cookies, history, and code examples in many languages. The same client runs as a desktop and web app.

Linting and governance

Stoplight style guides and Scalar rules are both Spectral under the hood, so the rules themselves carry over. You can export a Stoplight style guide with Export Spectral File in Studio, as shown in the migration guide, and load it as a Scalar rule. Rules that rely on custom JavaScript functions need rework.

Locally and in CI, Scalar's CLI runs the same rules:

npx @scalar/cli document lint openapi.yaml

Mocking

Stoplight mocks with Prism, hosted per project. Scalar's mock server is open source and runs wherever you want it, from the CLI, from Docker, or inside a Node.js app, with custom handlers and seed data:

npx @scalar/cli document mock openapi.yaml --watch

If you prefer Prism, keep using it. It reads the same OpenAPI document.

After the docs: SDKs and MCP

This is where the products diverge most. Stoplight is a design and documentation platform; it does not generate SDKs or MCP servers.

Scalar generates SDKs from the same OpenAPI document. TypeScript, Python, Go, and CLI are generally available; Java, Kotlin, Ruby, C#, PHP, Rust, Swift, Dart, and C++ are experimental. One SDK is included on every plan. Scalar also hosts MCP servers generated from your OpenAPI document, with OAuth, so AI agents can call the operations you choose.

If your roadmap ends at "publish good docs", this section does not matter. If it continues to client libraries and agent access, having all of it driven by one description in one platform removes a lot of glue.

Ownership and direction

Stoplight is one product in SmartBear's portfolio, alongside Swagger, SoapUI, and Pact. SmartBear's announcement said Stoplight's open-source catalogue would join SmartBear's open-source projects. Scalar is an independent company whose whole product is this workflow, with the renderer and client developed in the open on GitHub. Neither structure is inherently better. It is worth knowing which one you are buying into.

Feature map

Most Stoplight features have a direct counterpart in Scalar. A few do not, and they are listed honestly.

The last row is what Scalar adds on top of the design-first loop. The rows above it are why the move is usually straightforward: the underlying OpenAPI files, Spectral rules, and URLs carry across.

Pricing

Both vendors publish their prices, which makes this easy to check.

The comparison depends on team size and on what you need past documentation. For one to three people who only need a private designer, Stoplight Basic is cheaper. Once you need custom domains (Stoplight Startup) or SSO (Stoplight Pro Team at $362/month billed annually, versus Scalar Business at $600/month), the numbers move closer, and Scalar's plans also include SDKs and hosted MCP servers that Stoplight does not offer at any price. Run your own numbers; both pricing pages have enough detail to do it.

Migration path

The big advantage is that both platforms are built on OpenAPI and Git, so your core descriptions move without conversion.

The full walk-through, including Markdown guides and redirects, is in the Stoplight migration guide. For larger workspaces, book a migration call; this is a migration we know from both sides.

Which should you choose?

Stay on Stoplight if your API contracts are designed by people who prefer forms to YAML, you depend on GitLab, Azure DevOps, or Bitbucket integration inside the platform, you have a mature governance programme built around Stoplight style guides and workspaces, or you are a very small team for whom Basic covers everything.

Choose Scalar if you want an open-source renderer and API client you can self-host anywhere, docs mounted inside your application, SDKs and hosted MCP servers from the same description, or an independent vendor whose whole product is this workflow.

Start free or talk to us.

Frequently asked questions

Related

• Learn: Spectral rules · API mocking
• Docs: Migrate from Stoplight · Stoplight alternatives · Registry CLI
• Product: Scalar Docs — hosted docs, guides, and API references from one Git-synced config

This comparison is based on Stoplight's public pricing page, open-source repositories, npm releases, and SmartBear's acquisition announcement as of September 2026, and on Scalar's own source. Stoplight is owned by SmartBear and its product direction may change. We have made a genuine effort to be accurate and to state where Stoplight is better. If you find something wrong or out of date, please open an issue and we will correct it.