Skip to content
SPECIFICTION
Get listed

Stoplight Elements

stoplight.io

Free plan WebSelf-hosted
Visit stoplight.io
Spec score 7.3 #16 of 28 in Rest Apis

What it is

Stoplight Elements is a free, open-source set of embeddable web components for building interactive API documentation from OpenAPI documents. It adds customizable left navigation and a three-column layout, while an embedded console lets readers try requests and inspect responses within the documentation. Elements supports OpenAPI, including version 3.1, and JSON Schema. It provides code samples in Curl, Python, Ruby, and Java, and its Stoplight-flavored Markdown supports tabs, callouts, and embedded JSON examples. The components require no build steps and can be used with any framework or HTML project. Documentation can be hosted anywhere, including S3 or GitHub. Elements can point to an OpenAPI document or a Stoplight Workspace and can work with any OpenAPI editor. The listed plan costs nothing and includes OpenAPI 3.1 support, an interactive API console, embedding into an existing CMS, and hosting anywhere. Compared with Elements DevPortal, the product page does not list multiple API listings, mocking, Markdown articles, branch version selection, or search. Stoplight identifies SmartBear as its parent company.

Spec sheet

What it does
Stoplight Elements builds customized, interactive API documentation from OpenAPI documents using embeddable web components.Read 2 Oct 2026 · stoplight.io
Free plan
YesRead 20 Sep 2026 · stoplight.io
Security
Stoplight says it uses industry-standard technologies and services to protect data and conducts employee background checks and recurring security training.Read 2 Oct 2026 · stoplight.io
Headquarters
Somerville, Massachusetts, United StatesRead 28 Sep 2026 · stoplight.io
Maker
The Stoplight site identifies SmartBear as its parent company.Read 2 Oct 2026 · stoplight.io
Code samples
Elements provides code samples in languages including Curl, Python, Ruby, and Java.Read 2 Oct 2026 · stoplight.io
Developer layout
It offers customizable left navigation and a three-column layout for browsing API documentation.Read 2 Oct 2026 · stoplight.io
Examples
The product page says Spotify uses Elements for its “Get Artist” documentation on Spotify for Developers.Read 2 Oct 2026 · stoplight.io
Hosting
The product page says Elements can be hosted anywhere, including S3 or GitHub.Read 2 Oct 2026 · stoplight.io
Integration
Elements can use any OpenAPI editor and optionally point to an OpenAPI document or a Stoplight Workspace.Read 2 Oct 2026 · stoplight.io
Interactive console
The embedded API console lets readers test requests and responses within the documentation.Read 2 Oct 2026 · stoplight.io
Markdown
Stoplight-flavored Markdown supports tabs, callouts, and embedded JSON examples.Read 2 Oct 2026 · stoplight.io
Notable limits
Compared with Elements DevPortal, Elements does not list multiple APIs, mocking, Markdown articles, branch version selection, or search.Read 2 Oct 2026 · stoplight.io
Setup and frameworks
Elements requires no build steps, is built on web components, and can be used with any framework or HTML project.Read 2 Oct 2026 · stoplight.io
Standards
Elements uses OpenAPI and JSON Schema, including OpenAPI 3.1 support.Read 2 Oct 2026 · stoplight.io

Plans and prices

Stoplight Elements Free Open-source API documentation building blocks · Embed into existing CMS · Host anywhere · Interactive API console · OpenAPI 3.1 support Read 2 Oct 2026 · stoplight.io

Every Stoplight Elements plan and price →

Strong points and limits

Strong points

  • Free and open-source documentation components
  • Interactive console for testing requests and responses
  • OpenAPI 3.1 and JSON Schema support
  • Works with any framework or HTML project
  • Can host on S3, GitHub, or elsewhere

Limits

  • No mock server is listed
  • Requires separate handling of hosting and integration

Who it suits

Elements suits developers who need self-hosted, embeddable API reference documentation from OpenAPI files.

Verdict

Stoplight Elements focuses on embedding interactive OpenAPI documentation into existing sites without a build step. Its free self-hosted model is well defined, while the omitted DevPortal features may matter for larger documentation programs.

Where Specifiction places it

Alternatives to Stoplight ElementsAll alternatives →