Every API needs documentation, but “documentation” now means three different things depending on which tool you pick: a spec-authoring workflow (Swagger/OpenAPI and SwaggerHub), a docs-as-code publishing platform (Redocly), or a design-first collaboration suite that’s in the middle of being absorbed into a bigger platform (Stoplight). All three sit on top of the same underlying standard — the OpenAPI Specification — but they solve different parts of the problem, and in 2026 the competitive picture is more tangled than it looks because of an acquisition that’s reshaping two of these three tools from the inside.
At a Glance
| Tool | Starting Price | Free Tier | Best For | Key Specs |
|---|---|---|---|---|
| Swagger / OpenAPI tools | Free (Swagger Editor, Swagger UI, Swagger Codegen are open source) | Yes — the core tools have no paid tier at all | Teams that just need to author, validate, and render an OpenAPI 3.x document without a hosted platform | Supports OpenAPI 3.2 (released September 2025); SwaggerHub is the commercial hosted layer on top |
| SwaggerHub (SmartBear) | Not published as self-serve tiers; quote-based via SmartBear sales | No published free collaborative tier as of this writing | Teams that want hosted, versioned OpenAPI authoring with team collaboration, now converging into SmartBear’s broader “API Hub” | Being consolidated with Stoplight’s capabilities under SmartBear’s API Hub umbrella following SmartBear’s 2023 Stoplight acquisition |
| Redocly | $249/month (Pro), billed annually ($2,988/year) | No free collaborative tier; open-source Redoc renderer is free | Teams that want a polished, Git-based docs site with strong theming and governance (linting, style guides) | Scale tier $729/month ($8,748/year); Enterprise is custom |
| Stoplight | Not published as self-serve tiers; being folded into SmartBear API Hub | Open-source components (Spectral, Prism, Elements) remain free | Teams already using Stoplight Studio for design-first API modeling, during the SmartBear transition | SmartBear announced its agreement to acquire Stoplight on August 22, 2023; its commercial product is being merged into API Hub rather than sold as a fully separate product going forward |
Short Verdict
If you just need to write and preview an OpenAPI document, the free, open-source Swagger tools (Editor, UI, Codegen) still do the job with zero cost and zero lock-in. If you want a genuinely good-looking, Git-native documentation site with strong linting and governance, Redocly is the clearest, most transparently priced option of the three. If you’re evaluating Stoplight or SwaggerHub today, the more important fact than any feature comparison is that both are owned by SmartBear and are actively converging into a single product called API Hub — so the real decision isn’t “Stoplight vs. SwaggerHub,” it’s “do we want SmartBear’s consolidated platform, and are we comfortable buying into a product that’s mid-merger.”
What Each One Actually Is
Swagger / OpenAPI. “Swagger” is the original name of what’s now the OpenAPI Specification (OAS), the open, Linux Foundation-governed standard for describing REST APIs in a machine-readable YAML or JSON document. The free Swagger tooling — Swagger Editor (browser-based spec authoring with live preview), Swagger UI (renders a spec as interactive, “try it out” documentation), and Swagger Codegen (generates client SDKs and server stubs from a spec) — remains open source and free to self-host. OpenAPI 3.2, released in September 2025, is a backward-compatible update to 3.1 that added hierarchical tags, native streaming media types, a new safe-but-body-carrying QUERY HTTP method, OAuth 2.0 Device Authorization Flow support, and clearer example formatting. None of that requires a paid product — you can write a 3.2 document in a text editor and render it with the free Swagger UI.
SwaggerHub is SmartBear’s commercial, hosted layer on top of the open Swagger tools: versioned spec storage, team collaboration, style validation, and an integrated mock server and domain registry. Crucially, SmartBear has been restructuring its product lineup — SwaggerHub Portal was folded into a product called “API Hub for Portal” in early 2025 and later simply renamed “Swagger Portal,” and SmartBear’s broader messaging now frames SwaggerHub’s capabilities, plus Stoplight’s, as part of one unified “API Hub.” If you’re pricing this out today, expect to go through a SmartBear sales conversation rather than a self-serve checkout page — the company’s current pricing pages route to a trial request or a sales contact rather than publishing fixed per-seat numbers.
Redocly is a docs-as-code platform built around the open-source Redoc rendering engine. Instead of a web-based editor, Redocly’s model is Git-first: you write OpenAPI/Markdown/Markdoc content in your own repository, Redocly builds and hosts the site, and pull requests get preview deployments. It layers on API linting (via the open-source Redocly CLI and its ruleset engine), an API catalog for organizations managing many specs, SSO, and — new in its current plans — an AI Assistant for both doc readers and an “Agent” feature for automated PR reviews.
Stoplight began as a design-first API platform: a visual spec editor (Stoplight Studio), a mock server (Prism), a linter (Spectral), and a documentation renderer (Elements) — the last three of which are open source and still maintained. SmartBear announced a definitive agreement to acquire Stoplight on August 22, 2023, explicitly framing the deal as bringing design, documentation, and governance capabilities into SmartBear’s platform so that, in SmartBear’s own words, “developers no longer need to choose between these tools.” In practice, that means Stoplight’s commercial product is being absorbed into API Hub rather than continuing indefinitely as a fully independent product line with its own roadmap and pricing page.
Pricing Breakdown
| Plan | Price | Notes |
|---|---|---|
| Swagger Editor / UI / Codegen | $0 | Open source (Apache 2.0); self-hosted, no account required |
| SwaggerHub (all tiers) | Not published — contact SmartBear sales | SmartBear’s current product and pricing pages for SwaggerHub/API Hub route to a trial signup or sales contact rather than listing fixed self-serve prices as of this writing |
| Redocly Pro | $249/month, billed annually ($2,988/year) | Unlimited seats and readers; 3 projects (additional projects $390/year each); mock server, custom domain, MCP server for docs |
| Redocly Scale | $729/month, billed annually ($8,748/year) — marked “Most popular” | Adds SSO, RBAC, multi-product sites, API catalog/scorecards, SDK generation (early access) |
| Redocly Enterprise | Custom, annual contract | Adds SCIM, audit logs, data residency, single-tenant options, SLA-backed support |
| Stoplight (all tiers) | Not published — being integrated into SmartBear API Hub | Historical Stoplight pricing was per-user with per-month billing, but the standalone pricing page no longer lists fixed tiers; open-source Spectral, Prism, and Elements remain free |
We checked each vendor’s current, live pricing page directly rather than relying on third-party aggregator sites, several of which list specific SwaggerHub and Stoplight numbers that are explicitly flagged by those same aggregators as unverified or years out of date. Redocly’s numbers above come straight from its own pricing page. For SwaggerHub and Stoplight, both of SmartBear’s live pricing surfaces currently route to a trial-request or sales-contact flow rather than displaying fixed self-serve tiers — a direct consequence of the ongoing Stoplight-into-API-Hub consolidation — so if exact current per-seat pricing matters for your budgeting, request a quote directly from SmartBear rather than trusting a third-party number.
Pros and Cons
Swagger / OpenAPI (open tools)
- Pros: completely free, no vendor lock-in, huge ecosystem of compatible tooling, supports the current OpenAPI 3.2 spec
- Cons: no built-in hosting, team collaboration, or governance — you assemble those yourself or pay for SwaggerHub/another platform
SwaggerHub
- Pros: tight integration with the Swagger tooling developers already know; backed by SmartBear’s broader API quality and testing portfolio (ReadyAPI, Pactflow)
- Cons: pricing requires a sales conversation; the product is actively being restructured into API Hub, which creates near-term roadmap and migration uncertainty for existing customers
Redocly
- Pros: transparent published pricing, polished default theming, strong Git-based workflow with PR previews, genuinely useful linting via its open-source CLI
- Cons: no free collaborative tier — the cheapest paid plan is $249/month; per-project add-on costs can accumulate for organizations with many separate APIs
Stoplight
- Pros: strong design-first visual editor for teams that prefer modeling a spec visually over hand-writing YAML; its open-source components (Spectral linting, Prism mocking, Elements rendering) are mature and widely adopted independently of the commercial product
- Cons: the standalone commercial product’s long-term shape is unclear while it’s being merged into API Hub; new customers evaluating it today are effectively evaluating SmartBear’s broader platform, not a standalone Stoplight
Who It’s a Good Fit For
- Choose the free Swagger/OpenAPI tools if you want zero cost, zero lock-in, and you’re comfortable wiring up your own hosting and review workflow.
- Choose Redocly if you want a docs-as-code workflow with clean, published pricing and don’t mind paying from day one — it’s the most straightforward of the three to budget for.
- Choose SwaggerHub or Stoplight only after talking to SmartBear directly about current pricing and the API Hub migration timeline — both are reasonable choices if you’re already invested in SmartBear’s ecosystem (ReadyAPI, Pactflow, etc.) and want one vendor relationship.
Who Should Look Elsewhere
Teams that need a free, self-serve collaborative editor with multiple seats and no sales call should look at other hosted OpenAPI editors in the market before assuming SwaggerHub or Stoplight will have an accessible entry-level price — neither currently publishes one. Teams that want the absolute lowest cost and are willing to self-host should stick with the open Swagger tools rather than paying for any hosted platform at all. And teams specifically wary of buying into a product mid-acquisition should treat Stoplight’s standalone future as an open question rather than a settled one, since SmartBear’s own public statements frame it as being absorbed into API Hub rather than continuing as a fully separate roadmap.
Bottom Line
The “Swagger vs. Redocly vs. Stoplight” framing undersells how much has changed since these three tools were cleanly distinct competitors. Swagger/OpenAPI is the free, open foundation all of this sits on, and that hasn’t changed. Redocly has pulled ahead on pricing transparency and polish for teams that want a dedicated docs platform. Stoplight and SwaggerHub, meanwhile, are both owned by SmartBear and are being merged into a single “API Hub” product — which means the real 2026 decision for anyone evaluating either one isn’t a feature checklist, it’s whether you’re comfortable adopting a platform that’s actively consolidating two previously separate tools into one.
FAQ
Is Swagger the same thing as OpenAPI? Historically yes — “Swagger” was the original name of the specification before it was donated to the Linux Foundation and renamed the OpenAPI Specification in 2016. “Swagger” now refers to SmartBear’s branded tooling (Swagger Editor, Swagger UI, SwaggerHub) built around that open standard.
Are Stoplight and SwaggerHub the same product now? Not fully merged as of this writing, but they are converging. SmartBear acquired Stoplight (agreement announced August 22, 2023) and has since been integrating its capabilities, along with SwaggerHub’s, into a product it calls API Hub.
What’s new in OpenAPI 3.2? Released in September 2025, it’s a backward-compatible update to 3.1 adding hierarchical tags, native streaming media type support, a new QUERY HTTP method for safe searches with a request body, OAuth 2.0 Device Authorization Flow security support, and refined example fields.
Can I use Redoc (the open-source renderer) without paying Redocly? Yes — Redoc itself is open source and free to self-host for basic spec rendering. The paid Redocly plans add hosting, Git-based workflows, linting-as-a-service, team collaboration, and the newer AI features.
Why can’t I find published prices for SwaggerHub or Stoplight? Both vendors’ current live pricing pages direct visitors to a free trial signup or a sales contact rather than listing fixed self-serve tiers, which appears to reflect SmartBear’s ongoing restructuring of both products into its unified API Hub offering.
Sources
- Redocly — Pricing
- Redocly — What’s New in OpenAPI 3.2
- Swagger — Launches Support for OpenAPI 3.2.0
- SmartBear — To Acquire Stoplight to Deliver Industry’s Broadest Portfolio of API Development Capabilities (news release)
- SmartBear — SmartBear’s API Development Hub Gets the Green Light with Stoplight
- SmartBear — API Hub / Swagger Portal Release Notes
- SwaggerHub — Pricing
- Stoplight — Pricing
Discover more from Software Online Review
Subscribe to get the latest posts sent to your email.
