Redocly Review 2026
Redocly treats documentation as code and builds every workflow around Git. This review assesses the editor, API rendering, review process, reader assistant, and analytics through hands-on use, and explains what each flat-priced plan includes and which teams the platform suits.
Monika B. · GTM Engineer, Documentation.AI
Last updated

On this page
Redocly is the platform your engineers already trust. Redoc, its open-source renderer, has been the default answer to "how do I make an OpenAPI file readable" for years, and the commercial platform is built on the same conviction: documentation is code, and code moves through Git. Everything Redocly does well follows from that, and every place it slows down is somewhere that conviction meets a person who does not write code.
Everything below comes from building on the platform and from Redocly's own pricing page, product documentation, and engineering blog, with an access date on every citation. Where we describe what other teams report, we say plainly how thin the public evidence is.
Redocly Review: The Verdict
Redocly is the platform in this category that commits hardest to docs-as-code, and the weakest one for a mixed team. Rendering, Git workflow, and governance are all excellent. Editing is a Markdown file in an IDE, every AI that writes is in beta or early access, and the reader assistant and MCP server now come with every plan while analytics and SSO start on Scale.
Our overall score is 3.5 out of 5, the unweighted average of the eight scores below, rounded to one decimal. Every review in this series is scored on the same eight criteria, so the rows compare directly from one platform to the next.
| What we rated | Score | Why |
|---|---|---|
| Editing and structuring | 2.5 | A capable Markdown IDE, no block editor, and a pull request for every change |
| API reference and explorer | 4.6 | Redoc rendering across four specification formats, mock servers, and a Replay console |
| Published output and design | 4.0 | Clean and deeply customizable, once somebody has learned the theming system |
| AI authoring and the agent | 2.0 | Reviewer is a beta on every plan, Writer is Enterprise, and nothing drafts in the editor |
| Reader AI and search | 3.6 | Fast answers with sources on every plan, free during beta, with the price at launch still unannounced |
| Analytics and reader insight | 3.4 | Verbatim AI conversations and failed searches, from the $729 Scale plan up |
| Governance and collaboration | 4.5 | Page-level RBAC, SSO with SCIM, real pull request review, and an SLA from the entry plan |
| Pricing and value | 3.4 | One flat price with unlimited seats and pages, from $249 a month and no free tier |
Buy Redocly if your API description is the source of truth, your documentation lives in a repository, engineers write most of it, and you want a review workflow that is your Git workflow rather than an imitation of one.
Look elsewhere if writers, product managers, or support leads need to edit without a pull request, you expect AI to draft or maintain content today, or you need reader analytics and SSO without paying for the $729 Scale plan.
The honest framing is that Redocly has spent 2026 making documentation legible to machines rather than easier for humans to write. That is a defensible bet, and it is not the bet most documentation teams are making.
What Is Redocly Built For?
Redocly is built for engineering teams that treat documentation as part of the codebase. The platform assumes a repository exists, that changes arrive as commits and pull requests, and that the person writing is comfortable with Markdown, YAML, and a file tree.
The product has carried a lot of names, and decoding them used to be the first real task. Redoc is the API reference renderer, the open-source project with more than 25,000 GitHub stars, and the base of the platform. Reunite is the workspace where you edit, review, and deploy. Respect is API monitoring built on Arazzo workflows, now part of Enterprise. Revel, Reef, and Realm were the paid modules that, with Redoc, made up the old per-seat plans, and those plans are closed to new subscribers. In their place are three flat-priced plans, Pro, Scale, and Enterprise, each with unlimited seats and pages, so the names no longer multiply your bill. [1]
What Redocly is not is a knowledge base, a help center, or a place where non-technical contributors write. There is no ticketing, no support deflection reporting, and no editing surface that hides the file system.
Redocly Features: What Stands Out
The Editor Is a Markdown IDE
There is no block editor in Redocly, and this is the single most important sentence in the review. You write Markdown in a file, in a pane, with a file tree beside it. A toolbar inserts headings, bold, italics, links, blockquotes, code blocks, ordered lists, unordered lists, and checkbox lists, plus six Markdoc tags: if, else, table, partial, admonition, and code snippet. [2]

For a developer this is comfortable and fast. Tabs split into groups, search does regex and find-and-replace across folders, and you can drag an image from your desktop into a Markdown file and Redocly files it into the nearest images folder for you. [2] It behaves the way a code editor behaves, because it is one.
The component library sits behind Markdoc tags rather than a slash menu, so adding a card group or a code walkthrough means knowing the tag exists and typing it. There is a tag library in Redocly's documentation, and the editor can open that documentation in a side tab, but nothing surfaces a component while you type.
A Live Preview, the Manual, and an API Console
The utility pane carries three tabs, and using them together is what makes the daily experience work. Webview renders whatever you are editing as it would publish, updating as you type, with device presets from mobile to desktop HD and a status bar showing your page count and every build error with its location. [2] Docs opens Redocly's own documentation beside your file, so the Markdoc tag you cannot remember is one tab away rather than one browser window away. Replay is an API console for testing requests against your description without leaving the editor. [2]

The Docs tab is labeled beta. Raw Markdown in one pane and a live Webview render in the other is where most of the work happens, and it beats the single preview pane most competitors offer. Separately, a preview deployment fires on every commit to a branch with an open pull request, and if you connected GitHub that preview appears as a check on the pull request itself. [2]
A Git Workflow That Is Actually a Git Workflow
Redocly is the only platform in this comparison with no editing surface that hides Git from you, and that turns out to be the point rather than the limitation. Branch, commit, review the diff file by file, deselect what you do not want to include, write a message, open a draft pull request. The commit history panel shows what is ahead of and behind main, with a Sync button, and hovering a commit shows the author, the message, the timestamp, and the hash. [2]

Reviewers see the rendered result rather than the raw diff, which documentation teams ask for and rarely get. Versioning is a folder convention: create subfolders starting with @, such as @latest or @1.0.0, and a version picker appears in the sidebar automatically. [2] Remote content pulls files from other repositories into the project, so a monorepo's documentation can live next to its code, though that one starts on Scale. [1]
Published Docs That AI Tools Can Actually Read
Redocly has spent 2026 on this and it shows. Every project ships an MCP server at /mcp with nothing to build and nothing to host, exposing search, API listing, and endpoint details, with your access control enforced on every call. Opening that URL in a browser gives a setup page with one-click configuration for VS Code and Cursor. [3] The MCP server is included on every plan while it is in beta, and MCP analytics, which shows what agents call and ask, is Enterprise. [1]
Alongside the server you get llms.txt in the standard format, including OpenAPI code samples and response samples. You can drop SKILL.md files into an @skills folder so agents follow your instructions rather than guessing from reference pages, and the project publishes MCP and A2A agent cards so agents can discover it on their own. [2] [3] Page actions let a reader copy any page as Markdown or hand it straight to ChatGPT or Claude, and the same menu offers to install your docs MCP server in Cursor or VS Code. Beyond the file and the server, a third layer called WebMCP lets a page register tools for an agent running in the reader's browser; it is in origin trial in Chrome and Edge and replaces neither.

If your worry is that developers now ask an assistant before they open your documentation, Redocly has an unusually complete answer. That answer is publishing infrastructure for machines, not help for the person writing the page.
Ask AI on the Published Site
The reader-facing assistant is good. It answered fast, in complete sentences, and cited the pages it drew from, which is the behavior that decides whether readers trust it. You can configure suggested questions, set a hidden system prompt that shapes tone, and choose whether it appears as a floating button or an icon. [2]
It comes with caveats. It is included on every plan from Pro up while it is in beta, held back by fair-use rate limits rather than a meter, and Redocly says usage-based pricing arrives at general availability with at least 60 days' notice, so there is a line on a future invoice you cannot size yet. The embeddable widget that puts the same assistant inside your own app starts on Scale. [1] And its index only builds on the production branch, so a search configuration change does not take effect until your next production deploy. [2]
Docs stuck behind a PR?
Writers who can ship without one
Import your Markdown from Git, then let writers edit and publish without opening a pull request.
No credit card required
Where Redocly Slows Down
Six things to weigh: two structural choices Redocly has made deliberately, two plan boundaries, a short set of limits that prompt rather than bill, and how little independent evidence exists to check us against.
Non-Technical Contributors Are Effectively Locked Out
A product manager who spots a wrong sentence cannot fix it. They can learn the file tree, find the Markdown file, edit it, commit to a branch, open a pull request, and wait for a review. Or they can send the correction to an engineer. Most stakeholders will take the second option, and the documentation then ages at the speed of engineering attention.

This is the complaint that recurs most often about Redocly, and it is true by design rather than by omission. The editor is very good at what it does. What it does is edit files.
The learning curve compounds it. Customizing the published site means learning Redocly's theming system, its CSS variables, and its component ejection model, and that is a skill rather than a settings page. Budget more time for a polished site than the templates suggest.
Every AI That Writes Needs Redocly's Permission
There is no AI writing assistant in the editor. Nothing drafts a page, expands a paragraph, or turns your spec into prose while you work, and Redocly's own positioning is explicit about why: "AI writes. Redocly verifies." [3] You prompt your own model somewhere else and bring the result back for linting and review.
Redocly Agent does have a writing half. Writer turns user feedback and analytics into proposed changes and opens draft pull requests. Reviewer is the more interesting product: it comments line by line when a pull request opens, checking API descriptions for breaking changes, Markdown against the OpenAPI it references, security risks framed by the OWASP API Security Top 10, and contradictions between pages, and it never blocks a merge. Redocly reports more than 11,900 issues surfaced across 1,700 pull requests in early access, with about 40 percent fixed. [3]
Now the catch, and it applies to both halves. Both are beta. Reviewer is now listed on every plan with usage limits, and Writer, which drafts fixes as pull requests, is Enterprise only. [1] Neither has a price yet, because Redocly will only charge for AI usage once it reaches general availability, so you can use Reviewer today but cannot budget for it past the beta.
The gap is worth naming precisely. Writer is designed to work from search queries, feedback, and page analytics, and those reports start on Scale while Writer itself sits on Enterprise. The agent that fixes your documentation is two plans above the entry price.
Separately, the AI Assistant inside Reunite answers questions about your Redocly setup: your plan, your members, your build logs, your configuration. [3] Genuinely useful for "why did my build fail", and not a writing tool.
Analytics Exist, and They Start on Scale
Redocly's analytics are better than we expected and further up the price list than most buyers expect. You get page views and unique users with a top-pages table, referring domains, and CSV export. You get search queries with a Most not found filter, which is a list of what your documentation is missing, written by the people who needed it. And you get AI Assistant conversations expanded to the full question, the answer, and the sources, with likes and dislikes. [2] A separate Feedback report collects page-level feedback and code snippet reports with a status workflow. [2]
That is a strong set, and the pricing page lists project analytics under Scale, so on the $249 Pro plan you publish blind. [1] Two smaller catches sit underneath. Analytics depends on telemetry, so setting REDOCLY_TELEMETRY to off in production silently produces an empty dashboard. [2] And only project admins and maintainers can see it, so a writer without that role cannot see how their own pages perform. [2]
Search, SSO, and Access Control Are the Same Boundary
Every project gets search. Search facets, which let readers narrow results by product, version, or any field you define, start on Scale, and so do SSO, platform RBAC, remote content, the embeddable assistant widget, and analytics. Page-level RBAC, SCIM, and audit logs are Enterprise, or annual add-ons to Scale through sales. [1]
That is one line, at $729 a month, and much of what a 2026 buyer shortlists on sits behind it. Pro is the renderer, Markdown and React pages, three projects, custom domain hosting, Reunite, the reader assistant, and the MCP server, so the real question in an evaluation is whether you need SSO or analytics from day one. [1]
Credit where it is due on one point the category usually gets wrong. Redocly's SLA sits in the standard subscription agreement rather than an Enterprise addendum, so 99.9 percent uptime and an average 24-hour support response apply from the entry plan up. [1] Very few competitors here commit to anything below Enterprise.
Every Limit Prompts Rather Than Bills
Redocly's invoice now carries two possible lines: the plan, and any extra projects you chose to add. There is no seat line, no usage line, and no overage. [1]
Seats are no longer counted. Owners, members, committers, billing users, and viewers are free in unlimited numbers on every plan, so a passing committer no longer becomes a paid seat. Redocly's billing documentation still describes seats, so treat the pricing page as the authority. [1]
Pages are unlimited. API operations no longer spend a page allowance. Very large sites sit under fair-use build and hosting rate limits, and Redocly asks teams expecting more than ten thousand pages to plan capacity with it first. [1]
Projects scale with the plan. Pro includes three, Scale ten, and Enterprise unlimited, and an extra project on Pro or Scale costs $390 a year. Reaching the limit prompts you to add one or change plan; it never adds a surprise charge or takes a published site down. [1] Our Redocly pricing guide prices the plans in full.
One More Thing, and It Is About the Evidence
Redocly has no Capterra listing, no Trustpilot profile, and zero user reviews on SourceForge and Slashdot. The public record is developer forums, competitor comparison pages, and tool directories, and the same observations recur across them: excellent rendering, unmatched ecosystem support, a dated dashboard, confusing product naming, costly customization, and a per-seat bill that grew at scale, which the move to flat plans has since answered. That is consistent enough to take seriously and thin enough that your own trial is the evidence that counts, so use all 30 days of it.
Redocly Pricing
Redocly has three plans, no free tier, and one flat price per plan, with unlimited seats, readers, Git contributors, and pages on all of them. Pro is $249 a month and Scale $729 a month, billed annually as $2,988 and $8,748 a year, and both are self-serve after a 30-day trial. Enterprise is a custom annual contract through sales. [1]

| Plan | Price, billed annually | Projects | What it adds |
|---|---|---|---|
| Pro | $249/mo ($2,988/yr) | 3 | API reference, Markdown and React pages, mock server, custom domain, protected docs, reader AI assistant and MCP server (beta) |
| Scale | $729/mo ($8,748/yr) | 10 | SSO, platform RBAC, project analytics, search facets, remote content, the embeddable assistant widget, SDK generation (early access), no Redocly attribution |
| Enterprise | Custom annual contract | Unlimited | Page-level RBAC, SCIM, audit logs, data residency, Writer, MCP analytics, Respect monitoring, dedicated support |
An extra project on Pro or Scale costs $390 a year. Annual billing is two months free against monthly, and the AI features carry no charge while they are in beta; Redocly will publish AI prices and the date at least 60 days before general availability. [1]
The old module plans, Redoc, Revel, Reef, and Realm, are closed to new subscribers. Existing customers can stay on them for at least a year, are mapped to a new plan by the capabilities they use, and keep their current price for 12 months if the new plan costs more. [1]
The number to plan against turns on one question: do you need SSO or analytics? For a team of five that wants Markdown documentation alongside its API reference and a reader assistant, that is Pro at $249 a month billed annually, and it is the same $249 for a team of fifty. Add SSO or analytics and it is Scale at $729.
Our Redocly pricing guide takes the plans apart, including what moves a team from Pro to Scale, what the 30-day trial includes, and worked bills for real teams.
Does It Fit Your Team?
It turns on two questions: does everyone who needs to edit your documentation already work in Git, and do you need to see how readers use the result?
| Your situation | Fit | What decides it |
|---|---|---|
| API-first product, engineers own the docs | Excellent | The review workflow is your Git workflow, with nothing in between |
| OpenAPI, GraphQL, AsyncAPI, or SOAP in the estate | Excellent | All four render, and Redoc handles them properly |
| Docs live in the same repository as the code | Excellent | Branch previews and provider status checks were built for exactly this |
| You want your docs readable by AI agents | Excellent | llms.txt, agent skills, agent cards, and an MCP server on every plan |
| Strict access control, SSO, or data residency | Good | SSO and platform RBAC on Scale, page-level RBAC, SCIM, and data residency on Enterprise |
| Writers or product managers edit daily | Poor | Markdown files, and a pull request for every change |
| You expect AI to draft or maintain content | Poor | Nothing drafts in the editor, and Writer is an Enterprise beta |
| Reader analytics on a small budget | Poor | Views, queries, and assistant usage start on Scale at $729 a month |
| A large API and a modest budget | Good | Pages are unlimited, so the operation count no longer moves the $249 price |
| Many engineers touch the docs repository occasionally | Excellent | Seats, committers, and readers are unlimited on every plan |
Before you sign, get answers to these:
- Who writes documentation today, and how many of them have opened a pull request in the last month?
- Do you need SSO, analytics, or the embeddable assistant on day one, since those decide between Pro and Scale?
- How many separate docs sites do you run, since Pro includes three and Scale ten?
- What will you budget for the reader assistant once Redocly prices AI usage at general availability?
- If the answer to a documentation question is currently "ask an engineer", what changes here to fix that?
Is Redocly Worth It in 2026?
Yes, if your documentation is code and the people writing it are engineers. Redocly's API rendering is among the best in this comparison, its Git workflow is the real thing rather than an imitation of one, and its agent-facing publishing is unusually complete. For that team, a flat $249 a month with nobody counted is a fair price, and a better one the larger the team.
That answer holds only if three things are true.
Editing is a developer skill here, and that is permanent. There is no visual editor on the roadmap and no path for a non-technical contributor that avoids a pull request, so if writers own your documentation, no plan upgrade makes this the right platform. [2]
AI helps your readers, not your writers. The published assistant is good and now on every plan, but Reviewer only reviews and Writer is an Enterprise beta, so nothing helps you draft. [1] [3]
The bill is simple now, and the AI line is still to come. Only the plan and any extra projects appear on an invoice, but the reader assistant and MCP server are free only while they are in beta, and Redocly has not yet said what they will cost at general availability. [1]
Our verdict stands at 3.5 out of 5, the lowest in this review series and the highest we would give it for the team it was built for. The difference between those two readings is whether your writers use Git.
Best Redocly Alternative
The closest alternative on capability is Documentation.AI, and the difference is who is allowed to write. Both run a Git workflow, publish an assistant on the docs, and expose content to AI tools. Only one of them lets a writer edit and publish without a commit.
Switches usually come down to three differences. Editing is visual as well as Markdown, so a product manager can fix a sentence without a pull request. Reader AI is on the free Starter plan with 10,000 credits, where Redocly has no free plan and starts at $249 a month. And the Pro plan at $159 a month billed annually includes unlimited seats and four projects, against three projects on Redocly Pro. [1] [4]
Redocly still wins on three counts worth naming. It is the only platform here where the documentation review is the same pull request review your engineers already run, with no sync layer and no second copy of the content. Reviewer, its pull request agent, has no equivalent in this comparison at all. And it renders SOAP alongside OpenAPI, GraphQL, and AsyncAPI, which almost nothing else in this field will do. [1] [3]
If neither fits, the field splits cleanly, and our roundup of Redocly alternatives prices all five side by side. Mintlify is the pick for API-first documentation where the team wants docs-as-code with a visual editor on top. GitBook is the pick for one collaborative site where a block editor matters most. ReadMe is the pick for developer portals that need per-key usage metrics. Fern is the pick for docs and SDKs generated from one API spec. Our Theneo review covers an API-first portal builder billed per workspace, and our Archbee review covers a knowledge portal that keeps customer guides, internal docs, and an API reference in separate spaces.
| Platform | Pricing model | Editing without Git | Best for |
|---|---|---|---|
| Redocly | $249/mo Pro, three projects, unlimited seats [1] | No, Markdown and a pull request | API references owned by engineers |
| Documentation.AI | $159/mo Pro billed annually, four projects, unlimited seats [4] | Yes, visual and Markdown | Mixed teams keeping several docs sets current |
| Mintlify | $450/mo Pro, unlimited editor seats [5] | Yes, visual mode with Git sync | API-first developer docs |
| GitBook | $65 or $249 per site/mo, plus $12 per user/mo [6] | Yes, block editor | One collaborative docs site |
| ReadMe | $250/mo Pro, one project, Ask AI $150/mo extra | Yes, hosted editor | Developer portals with usage metrics |
All five are the annual rates each vendor publishes.
Working out which plan you would actually land on?
Book a demo and we will price your real team: how many writers, how many committers, how many products, and what each platform charges for them.
Documentation.AI Slack channel: Join here
Deeper on each:
- Redocly pricing 2026, the three flat plans priced out in full
- Redocly vs Documentation.AI, the same documentation built on both platforms
- Mintlify vs Redocly, two flat-priced platforms built for API-first teams
- API documentation tools, the whole category compared at once
- Developer documentation tools, what engineering-owned documentation actually needs
FAQs
1. How Much Does Redocly Cost in 2026?
Pro is $249 a month and Scale $729 a month, billed annually as $2,988 and $8,748 a year, with unlimited seats and pages on both. Enterprise is a custom annual contract. Extra projects cost $390 a year each, there is no free tier, and our Redocly pricing guide works through what each plan includes. [1]
2. Does Redocly Have a Free Plan?
No. The hosted platform offers a 30-day trial. What is free is open source: the Redoc renderer and Redocly CLI, which render, lint, and bundle an OpenAPI description without an account. [1]
3. Can Non-Technical People Write Documentation in Redocly?
Not comfortably. The editor is a Markdown file editor with Markdoc tags and no visual mode, and every change goes through a pull request before it publishes. A writer can learn it. A stakeholder making an occasional correction will not. [2]
4. Does Redocly Have AI Writing Features?
Not in the editor. There is no writing assistant there. Redocly Agent's Reviewer comments on pull requests and is a beta on every plan, and its Writer role, which drafts fixes as pull requests, is an Enterprise beta. Neither has a published price yet. [1] [3]
5. Does Redocly Have Analytics?
Yes, on Scale and above: page views, top pages, referring domains, failed searches, and full AI assistant conversations, exportable to CSV. It depends on telemetry being enabled, and only project admins and maintainers can see it. [2]
6. Which Git Providers Does Redocly Support?
GitHub, GitLab, Azure DevOps, and Bitbucket Cloud, plus self-managed GitLab and GitHub Enterprise as separately registered instances. You can connect a whole repository or a single folder inside one, and for self-hosted providers Redocly publishes the IP addresses you need to allow through. [2]
7. Does Redocly Charge per Seat?
Not on its current plans. Owners, members, committers, billing users, and viewers are all free in unlimited numbers on every plan, and the price is per plan rather than per person. Customers still on the older Redoc, Revel, Reef, or Realm plans keep their existing billing until they choose to move. [1]
8. Does Redocly Limit Pages?
Not by count. Pages are unlimited on every plan and never billed, under fair-use build and hosting rate limits, and Redocly asks teams expecting more than ten thousand pages to plan capacity with it. What scales with the plan is projects: three on Pro, ten on Scale, and unlimited on Enterprise. [1]
Sources
- Redocly. "Pricing." Redocly. Accessed October 2026. https://redocly.com/pricing
- Redocly. "Redocly Docs." Redocly. Accessed September 2026. https://redocly.com/docs
- Redocly. "Redocly Blog." Redocly. Accessed September 2026. https://redocly.com/blog
- Documentation.AI. "Pricing." Documentation.AI. Accessed September 2026. https://documentation.ai/pricing
- Mintlify. "Pricing." Mintlify. Accessed September 2026. https://mintlify.com/pricing
- GitBook. "Pricing." GitBook. Accessed September 2026. https://www.gitbook.com/pricing
Docs stuck behind a PR?
Writers who can ship without one
Import your Markdown from Git, then let writers edit and publish without opening a pull request.
No credit card required



