Release Notes

Portal now has a new HTML-based editor. New portals created after today will only have access to the new editor. Existing portals can choose between the type of page they want to create. We highly recommend using the new editor for all new documentation.

Providers can now create product templates to encourage standardization across API documentation.

Providers can duplicate pages and move pages to other products. Learn more here.

Consumer view supports responsive web design.

Providers can create custom domains. Learn more here.

SwaggerHub Portal On-Premise is now available as part of SwaggerHub On-Premise. For more information, go to the On-Premise Administrator Guide.

SwaggerHub Portal supports color schemes: dark mode, light mode, and matching system.

Consumers can request access to products. Learn more here.

Providers can manage access requests. Learn more here.

Integration with Stoplight Elements for OpenAPI rendering.

Ability to nest pages and APIs. Learn more here.

Providers can navigate from the Consumer view to the provider view to make edits to the portal customization or product content. Learn more here.

New Notification Center that keeps users informed about the state of a product between publish actions. Learn more here.

Ability to route Try it Out requests via the browser or SwaggerHub Portal Proxy. Learn more here.

Information is provided when API resolving errors occur while previewing or publishing. Learn more here.

The publish confirmation modal will detail what changes have occurred in the product since the last publication.

Broken link indicator to inform users there is an issue with the already linked API. Potential reasons include:

Ability to provide granular access at the product level for private products. See our User Management page for more information.

Ability to insert the URL for an API endpoint when editing a page. Learn more here.

Ability to preview your portal before publishing. See here for more details.

In provider view, receive prompts and an icon for SwaggerHub API changes, reminding you to republish your product.

Support for SwaggerHub Explore on both the provider and consumer side of SwaggerHub Portal.

Private Indicator to show that an API is private in SwaggerHub . Learn more about linking APIs here.

You can now navigate to the SwaggerHub Portal API from your home screen:

The SwaggerHub Portal API is now live on our SmartBear Portal. You can use our API to automate the management of your own portal.

You can now navigate to SwaggerHub to manage users if you are the organization owner in your portal. Visit User Management to learn more about roles.

When you add new content or edit it in the provider view, a blue icon prompts that API or page contains unpublished changes.

Consumers can generate code for OpenAPI definitions. Also, they can download both OpenAPI and AsyncAPI in YAML or JSON format.

Now you can switch back from the consumer view to the provider view when you click the Go to Provider View button available in your profile.