There was so much to be excited about at Redocly and our superlative developer experience goal in the month of July. Not only did we give one of our most popular products a huge update, we also published a separate blog post about this!

But, this wasn't all we worked on in July. While our developers were polishing our products, our documentation team was busy keeping pace with our new features, and enhancing our documentation experience for our customers and their users as well.

This post is a round up of our product updates (including the big one in Reference docs 2.0), enhancements and documentation-related news from July 2021.


Support for configuring custom headers

You can add custom headers to response header objects for your Reference docs and Developer portals by creating a customHeaders.yaml file in the root directory of the project.

When building the project, Workflows reads the patterns from the file in top-to-bottom order and starts with the first matched pattern, so make sure to always place the general glob pattern (**/*) at the end of the file.

To find out how to do this, see our Configuring custom headers topic.

Improved access control for project types

Workflows now supports advanced access controls for all project types (API versions, Reference docs, Developer portals).

You can:

  • streamline collaboration by controlling people access at the project level,
  • invite external collaborators more easily, and
  • create teams to manage different groups of collaborators with different levels of access.

To read more, refer to our Managing access guide.

HSTS header for security

Implemented HTTP Strict-Transport-Security (HSTS) header to enhance the security of our services.

Workflows changelog Find out about other fixes and enhancements by visiting the Workflows changelog.

Workflow features

Reference docs

This is the biggest visual overhaul to Reference docs in 12 months. Not only is Reference docs sporting a new, clean look - it also has tons of usability and performance improvements.

Some of the more salient features include:

  • Sticky language selection in code sample tabs
  • Support for deep links
  • Support for OpenAPI 3.1
  • Improved search experience
  • Huge uplift in visual layout and Try it experience

You can read more about these changes in our Announcing Reference docs 2.0 blog post.

For the full list of changes and upgrade instructions, refer to our migration guide.

Redoc vs Reference docs

So, what does that mean for our famous open-source project, Redoc?

The Reference docs 2.0 release marks the biggest departure from Redoc in terms of the overall design and visual changes.

  • The list of features available only in Reference docs has also expanded, with deep links, customizable (and sticky!) code sample tabs, custom sidebar links, and new theming options.
  • Redoc will continue to provide an excellent API experience to all its users, but Reference docs 2.0 puts its users several steps ahead.

Reference docs changelog Here's a link to the entire Reference docs changelog.

Reference docs features

Developer portal

Import raw code samples into MDX pages

You can now import raw code samples from standalone files into MDX pages, similar to how you would import a React component.

To do this:

  • Save your code sample as a file in your portal project with the .sample.ext extension, where ext matches the code language extension (py, js...).
  • Import it at the beginning of your MDX page and insert it in the page body. For example:
import codeSample from './code-samples/code.sample.js';

# Page title

Page text

## Example section with code sample


Developer portal changelog Read the entire list of fixes and enhancements on the Developer portal changelog.

Developer portal features


OpenAPI CLI documentation is now open-source!

Our official OpenAPI CLI documentation is now open-source! You can find the source of all pages published on our website in the docs folder of the openapi-cli repository.

Help us improve the documentation and make it more usable for everyone. Please make sure to always follow our Code of conduct in all your contributions.

OpenAPI CLI changelog Read more about other fixes and enhancements by visiting the OpenAPI CLI changelog.

OpenAPI CLI features

Documentation updates

The technical writing team has been busy adding new content and updating existing content to ensure we are leaving little to no gaps between our product features and docs.

In July, we have added:

In July, we converted from a Texas limited liability company to a Delaware c-corporation.

Our corporate name has changed from Redocly LLC to Redocly Inc. We do have a new tax ID and corresponding W-9 for your records.

Latest from our blog

OpenAPI parameter types for great API de...

Great API design makes for great API experience. Pick the parameter type that's going to make everything easier for your user.

What to do when your API changes

APIs change, that's reality. What matters is how you communicate that; get it right and create a winning API experience by adding a changelog and API description versions.

Ensure consistent APIs with Redocly and ...

Put some magic API tools in your continuous integration and make a good API grow up to be a great API.