Stoplight Reviews in June 2025: User Ratings, Pros & Cons

Stoplight makes it easy to create api docs

What do you like best? - Simple to use - Can create tables, pictures to explain the api better to the client -> Visual OpenAPI Designer was added - Can test api with moc server What do you dislike? - No easy way to transfer a word documentation into stoplight - Not sure how we can check if the api doc is stoplight is in sync with the api - Not many tutorials on youtube - I wish there would be a better way to save the api doc as a microsoft word document (.doc) ...

Great spec-first enablement

What do you like best? Designing an API is extremely intuitive and simple. Mock testing is easy to configure. We are enabling concurrent front-end and back-end development to an agreed upon contract defined in Stoplight. What do you dislike? Management of common models and responses across projects. In a microservices world we are defining many stoplight projects, however, there are common elements that we would like to share between those projects. Making this more seamless would ...

Overall good with some small frustrations

What do you like best? I love how accessible Stoplight is to everyone in our organization. It has become an essential tool for planning and organizing our API - a tool that even non-technical people understand and grasp. I also love the hosted documentation - it fast and stable. What do you dislike? I come into Stoplight really used to the OpenAPI (swagger) spec. Sometimes it is really difficult to figure out how to do something with Stoplight that I already know how to do in ...

Great tool for DevOps teams working with Low-Code platforms

What do you like best? API Specification designer and the mock server What do you dislike? Some validations on de API designer aren't working properly. I have to refresh the page to recover the validation checks. Also when referencing to a model, a green check icon looks like a button. Almost everytime I click it. What problems are you solving with the product? What benefits have you realized? Developing/Delivering faster due to the agreements in the API contract.

Overall good with some small frustrations

What do you like best? I love how accessible Stoplight is to everyone in our organization. It has become an essential tool for planning and organizing our API - a tool that even non-technical people understand and grasp. I also love the hosted documentation - it fast and stable. What do you dislike? I come into Stoplight really used to the OpenAPI (swagger spec. Sometimes it is really difficult to figure out how to do something with Stoplight that I already know how to do in the ...

A powerful tool in general but still quite a few things to improve

What do you like best? The flexibility of defining API docs, tests and all relevant API stuffs in one single container, which makes it a powerful tool to use and it greatly addresses our e2e needs for API development. The designer mode is also my favorite, from which non-technical staffs could easily gain information. What do you dislike? Stoplight being a new tool and start-up company, many times I find the documentation is lagging behind and we would have to approach product ...

Great result, but not very intuitive authoring experience

What do you like best? I love how the end product looks and the try it out functionality. What do you dislike? It's a shame that we aren't hosting the docs ourselves, so we're missing out on any SEO data we could be gathering. This is also one of the most difficult tools I've ever used in terms of authoring experience in my 10+ years as a technical writer. If I have to change something that resides in an existing module, I have no way of knowing where it's being reused throughout the ...

Great result, but not very intuitive authoring experience

What do you like best? I love how the end product looks and the try it out functionality. What do you dislike? It's a shame that we aren't hosting the docs ourselves, so we're missing out on any SEO data we could be gathering. This is also one of the most difficult tools I've ever used in terms of authoring experience in my 10+ years as a technical writer. If I have to change something that resides in an existing module, I have no way of knowing where it's being reused throughout ...

Meh

What do you like best? I like the ability to create draft API before they become the real thing What do you dislike? I dislike the lack of "pull requests" before draft API becoming real APIs What problems are you solving with the product? What benefits have you realized? A central location for API documentation. It greatly supports multi-team collaboration

Meh

What do you like best? I like the ability to create draft API before they become the real thing What do you dislike? I dislike the lack of "pull requests" before draft API becoming real APIs What problems are you solving with the product? What benefits have you realized? A central location for API documentation. It greatly supports multi-team collaboration