WSO2 API Cloud documentation is getting a whole new look at
Try WSO2 Cloud for Free
Sign in

All docs This doc

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

theme consists of UI elements such as logos, images, landing page text, background colors etc. WSO2 API Store comes with a default theme called FancyThe easiest way to change the user interface of the API Store is by customising the default theme. 

All themes have the same folder structure as shown below. 

Because the default theme already has most of the UIs and JSON logic defined, in a typical scenario, you do not implement a theme from scratch. You can customise the default theme by bundling up the changes (e.g., CSS code, images) as a .zip file and uploading it through the Admin Dashboard Web application. Once uploaded, the files in the .zip override the corresponding files in the default theme. The rest is inherited from the default theme. 


Tip: You must only upload UI changes in the form of CSS code and images to override the default theme. Even if you upload JSON logic in the .zip file, it will not be applied due to security reasons.

Let's customise the default theme. See the video tutorial here or a step-by-step walk-through of the video tutorial below.

Widget Connector

Here's a step-by-step walk-though of the video tutorial:


  1. Download the default theme (i.e., Fancyfrom here, unzip it and rename the folder according to the name of your new theme (e.g., ancient). Let's call this folder the <THEME_HOME>.
  2. To change the logo of the API Store, replace the logo.png  file inside the<THEME_HOME>/images folder with this logo (or anything else of your choice.)
  3. Open the <THEME_HOME>/css/styles-layout.css file using a text editor and add the following CSS code to the end of the file. Note the code comments to get an idea what each line of code does.

    Code Block
    /* Change the color of the header */
    /* Change the font of the menus, headings, labels etc. to Verdana. You give several fonts here to ensure maximum compatibility, if in case one font fails in a given browser/OS. Fonts will be applied in the order you list them.  */
    body,textarea,pre,.navbar-search .search-query{
        font-family: Verdana, Arial, Helvetica, monospace, san-serif;
    label, input, button, select, textarea{
        font-family: Verdana, Arial, Helvetica, monospace, san-serif;
        font-family: Verdana, Arial, Helvetica, monospace, san-serif;
    /* To change the background color of the body */
    /* To change the color of the buttons. Note that changing only the background color will not have a visual impact if you leave the gradients as they are  */
    .btn-primary {
      background-color: #800004;
      background-image: linear-gradient(to bottom, #cc0022, #cc0044);
    /* To change the colour of the menus, navigation elements when they are clicked */
    .menu-content .navbar .nav > .active > a, .navbar .nav > .active > a:hover, .navbar .nav > .active > a:focus {
  4. Since you plan to upload this as a sub theme of the default main theme, delete all the files in your <THEME_HOME> folder except the ones that you just edited. The rest of the files will be automatically applied from the main theme.
  5. Go inside the <THEME_HOME> folder, select all the files/ folders inside it (Ctrl+A) and right click to archive all the selected files and folders together. Then rename the archive files to
  6. Log in to WSO2 Admin Dashboard Web application ( Your user name appears in the top, right-hand corner of the screen.
  7. The Admin Dashboard opens. Click the Upload Tenant Theme menu and upload your zip file.
  8. Open the API Store and note that your UI customisations are applied.

In this tutorial, you applied a few selected UI changes to the API Store.