Last updated

x-logo

Usage

Use x-logo to add a custom logo image to your API reference documentation. Add it to the info OpenAPI object.

When specified, the logo image is displayed above the navigation sidebar, on the left side of the API documentation page.

Field NameTypeDescription
x-logoLogo ObjectThe information about the API logo.

Logo Object

Field NameTypeDescription
urlstringThe URL pointing to the logo. MUST be in the format of a URL. It SHOULD be an absolute URL so your API definition is usable from any location.
backgroundColorstringOptional background color to use with the logo image. MUST be RGB color in hexadecimal format.
altTextstringOptional text to use for the alt HTML tag on the logo image. Defaults to 'logo' if nothing is provided.
hrefstringOptional URL pointing to the contact page. Defaults to 'info.contact.url' field from the API definition.

Examples

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'

In Reference docs

Custom logo image above the navigation sidebar