Skip to content
Kong Logo | Kong Docs Logo
search
  • We're Hiring!
  • Docs
    • Kong Gateway
    • Kong Konnect
    • Kong Mesh
    • Plugin Hub
    • decK
    • Kubernetes Ingress Controller
    • Insomnia
    • Kuma

    • Docs contribution guidelines
  • Plugin Hub
  • Support
  • Community
  • Kong Academy
Get a Demo Start Free Trial
  • Kong Gateway
  • Kong Konnect
  • Kong Mesh
  • Plugin Hub
  • decK
  • Kubernetes Ingress Controller
  • Insomnia
  • Kuma

  • Docs contribution guidelines
  • 3.3.x (latest)
  • 3.2.x
  • 3.1.x
  • 3.0.x
  • 2.8.x
  • 2.7.x
  • 2.6.x
  • Older Enterprise versions (2.1-2.5)
  • Older OSS versions (2.1-2.5)
  • Archive (pre-2.1)

github-edit-pageEdit this page

report-issueReport an issue

enterprise-switcher-iconSwitch to OSS

Kong Gateway
3.2.x
  • Home
  • Kong Gateway
  • Kong Enterprise
  • Dev Portal
  • Customize
  • Alternate OpenAPI Renderer
You are browsing documentation for an outdated version. See the latest documentation here.

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_render_type and the value stoplight or redoc. For example:

     spec_render_type: "stoplight"
    
  5. Refresh your Dev Portal to see that the change has taken effect.

Thank you for your feedback.
Was this page useful?
  • Kong
    THE CLOUD CONNECTIVITY COMPANY

    Kong powers reliable digital connections across APIs, hybrid and multi-cloud environments.

    • Company
    • Customers
    • Events
    • Investors
    • Careers Hiring!
    • Partners
    • Press
    • Contact
  • Products
    • Kong Konnect
    • Kong Gateway
    • Kong Mesh
    • Get Started
    • Pricing
  • Resources
    • eBooks
    • Webinars
    • Briefs
    • Blog
    • API Gateway
    • Microservices
  • Open Source
    • Install Kong Gateway
    • Kong Community
    • Kubernetes Ingress
    • Kuma
    • Insomnia
  • Solutions
    • Decentralize
    • Secure & Govern
    • Create a Dev Platform
    • API Gateway
    • Kubernetes
    • Service Mesh
Star
  • Terms•Privacy
© Kong Inc. 2023