Alternate OpenAPI Renderer

Through Kong Manager, use the Dev Portal Editor to customize how your API specs render in your Dev Portal.

To do this, add some custom code and update your config, as follows:

  1. In Kong Manager, navigate to the Dev Portal Editor from the left sidebar.

  2. Navigate to Themes > base > layout > system > spec.renderer.html.

  3. In spec.renderer.html, replace all of the current content with the content from this spec-renderer.html file. Doing so adds options for Stoplight and Redoc layouts.

  4. In theme.conf.yaml, add the parameter spec_renderer_type and the value stoplight or redoc. For example:

    1.  spec_renderer_type: "stoplight"

  5. Refresh your Dev Portal to see that the change has taken effect.