Skip to content

Hiding the logo in the API docs

Question

To remove the x-logo image from the openapi.yaml, do I need to hack the HTML or can I just remove the reference in the OpenAPI document?

Context

Redocly supports a specification extension x-logo that is added to the info object.

openapi: '3.0.3'
info:
  version: '1.0.0'
  title: 'Redocly Example API'
  x-logo:
    url: 'https://redocly.github.io/redoc/example-logo.png'
    backgroundColor: '#FFFFFF'
    altText: 'Example logo'
paths: {}

When the x-logo is present, Redocly will render the logo in the top left corner of the OpenAPI docs.

Answer

There are at least three ways to accomplish this task.

The two easiest ways are:

  • Remove x-logo from the OpenAPI file.
  • Use the hideLogo feature toggle.

Remove x-logo from the OpenAPI description

Given this initial API, remove the x-logo object.

openapi: '3.0.3'
info:
  version: '1.0.0'
  title: 'Redocly Example API'
  x-logo:
    url: 'https://redocly.github.io/redoc/example-logo.png'
    backgroundColor: '#FFFFFF'
    altText: 'Example logo'
paths: {}

After removing the object and rebuilding your docs, the logo will not be visible in the corner.

openapi: '3.0.3'
info:
  version: '1.0.0'
  title: 'Redocly Example API'
paths: {}

Use the hideLogo feature toggle

Sometimes you can't edit the OpenAPI file. Don't worry. Redocly has a feature toggle for that.

The feature toggle can be set in the Redocly configuration file.

This is an excerpt from the configuration file that demonstrates hiding the logo.

openapi.features:
  hideLogo: true

Now that you've seen how it works, try it with your APIs.

Let me know how it goes.

Latest from our blog

Code mode for MCP: up to 80% lower LLM c...

Redocly's MCP server lets AI agents combine documentation calls in a script and return only what matters. Less context to process. Lower LLM costs.

Stop reading the diff. Review the assump...

Code review is the bottleneck in most teams, and it does not have to be. Machines can read the lines. Humans need to read the premise, and they need to read it before the code exists.

Generate OpenAPI from real traffic (with...

The new generate-spec command infers an OpenAPI description from recorded HTTP traffic - with AI refinement.