Customizing the Appearance and Layout of Swagger UI

Swagger UI is an open-source tool that allows developers to interact with and visualize APIs using a user-friendly interface. While the default appearance and layout of Swagger UI are functional, you may want to customize it to align with your branding or to improve the overall user experience. In this article, we will explore various ways to customize the appearance and layout of Swagger UI.

Changing the Logo and Favicon

The default Swagger UI comes with a Swagger logo and a favicon. However, you can easily replace these with your own branding assets. To change the logo, simply replace the favicon-32x32.png file and swagger-logo.png file in the Swagger UI project directory with your own logos. Ensure that the sizes and formats match the originals to avoid any sizing or compatibility issues.

Next, update the index.html file located in the project directory. Look for the following lines of code:

<link rel="icon" type="image/png" href="favicon-32x32.png" sizes="32x32" />
<img id="logo" src="swagger-logo.png" />

Replace the href attribute of the <link> tag with the path to your custom favicon file. Similarly, update the src attribute of the <img> tag with the path to your custom logo file. Save the changes and access Swagger UI to see the updated logo and favicon.

Applying Custom CSS

To further customize the appearance of Swagger UI, you can apply custom CSS styles. Swagger UI provides a swagger-ui.css file that you can modify according to your needs. Locate the file in the project directory and open it in a text editor.

Inside the CSS file, you can add or modify styles to change various elements of Swagger UI, such as the background color, fonts, buttons, and more. Experiment with different styles until you achieve the desired look and feel.

Keep in mind that when making changes to the swagger-ui.css file, it's important to understand the CSS syntax and cascading rules. Make sure to test your modifications thoroughly to ensure they don't break the functionality or accessibility of Swagger UI.

Modifying the Layout and Structure

Swagger UI offers a flexible layout, allowing you to rearrange or modify its structure. By editing the index.html file, you can manipulate the placement of different components, move or hide elements, and customize the overall layout.

In the index.html file, you'll find HTML markup that represents the structure of Swagger UI. Depending on your requirements, you can modify this markup to change the layout and structure of the interface. For example, you can move the navigation bar, expand or collapse sections, or add custom elements to enhance the user experience.

Remember to avoid breaking the functionality of Swagger UI when making layout changes. Test your modifications thoroughly to ensure everything continues to work as expected.


Customizing the appearance and layout of Swagger UI allows you to create a branded and visually appealing API documentation experience. By changing the logo and favicon, applying custom CSS, and modifying the layout, you can align Swagger UI with your branding and enhance the overall user experience. Experiment with different customization options and find a design that best represents your organization's identity and style.

noob to master © copyleft