Sort API methods in Swagger-UI

Update for Swagger UI 2.1.0+: The sorter parameter has been split into two parameters, as noted in Fix 1040, Fix 1280:

apisSorter

Apply a sort to the API/tags list. It can be ‘alpha’
(sort by name) or a function (see Array.prototype.sort() to know how
sort function works). Default is the order returned by the server
unchanged.

operationsSorter

Apply a sort to the operation list of each API. It can be ‘alpha’ (sort by paths alphanumerically), ‘method’ (sort by
HTTP method) or a function (see Array.prototype.sort() to know how
sort function works). Default is the order returned by the server
unchanged.

So you’ll want to update sorter to apisSorter to sort the API list alphabetically, and/or operationsSorter to sort the operations list of each API. The pet shop demo has updated to apisSorter, as shown below:

Example: (working demo, sorted alphabetically)

window.swaggerUi = new SwaggerUi({

...

apisSorter : "alpha"
});

For Swagger UI versions older than 2.1.0:

The sorter parameter is still relevant for older versions of Swagger UI:

You can use the sorter parameter when instantiating SwaggerUi. This happens in the javascript on the Swagger-Ui index.html. From the documentation:

sorter apply a sort to the API list. It can be ‘alpha‘ (sort paths
alphanumerically) or ‘method‘ (sort operations by HTTP method).
Default is the order returned by the server unchanged.

Example:

window.swaggerUi = new SwaggerUi({

...

sorter : "alpha"
});

Leave a Comment