Publishing

What

Publishing your documentation has never been easier. Stoplight has added:

New Integrations for Segment, Intercom, and Google Analytics to allow for traffic monitoring and additional analytics
New Authorizations to make sure your documentation is secure at all times. This includes basic user/password authentication and SSO provider integration, powered by Auth0, SAML, and more.
New Builds section for tracking published Hubs, including when a Hub was published, who published it, and under what domain.

Take that Gutenberg!

Organization Owners, Account Owners, and Administrators can publish Hubs

From the Stoplight editor, click on the Publish icon in the far left-hand toolbar
Input a subdomain under Stoplight’s .docs.stoplight.io domain
- Or input a custom domain as shown below (optional)
Once completed, click Next ->
Select the Hub you wish to publish under Hub File

Publishing will use the latest version of the selected file (denoted by a star in the versions list)
Add Integrations to Segment, Intercom, and Google Analytics under Integrations (optional)
Add security via Username/Passwords Login, Auth0, or SAML (optional)
Once completed, click Publish in the top left
A confirmation window will ask you to confirm your selection, click Okay
Once confirmed, Build Logs will display your current progress
- The process usually takes 2-5 minutes
Once the process has completed, a green success message will display at the bottom of the screen, letting you know that the Hub was published succesfully
Once a Hub is published, it will appear under Builds
To unpublish a Hub, select Unpublish in the Danger Zone underneath Builds
- If you wish to delete all builds and release the domain you are currently using, select Remove Domain

Related Articles