Publishing your documentation makes it publicly available to anyone with the link to the documentation. Publish your documentation to help people around the world learn how to use your collection or interact with your public API.
Public documentation automatically includes details for each request or endpoint in the published collection, along with sample code in various client languages. As you update your collection, the published documentation automatically stays in sync with your latest changes. There's no need to publish the documentation again after making changes.
Your public documentation includes the Run in Postman button so users can interact with your collection or API directly in Postman. For an example, check out the Postman API documentation which was published from a Postman Collection.
To publish documentation, it must be part of a collection. You can publish documentation for any collections you've created or have permission to edit.
Publishing is only supported for collections with HTTP requests. Also, you can't publish a collection that has been added to an API. Instead, you can publish a version of the API. A published version includes the API's definition and collections.
To publish the documentation for a collection, do the following:
Select Collections in the sidebar.
Select the more actions icon next to a collection, and then select View Documentation.
Select Publish to navigate to the Publish Documentation interface.
In the Publish Documentation interface, change any publication settings as needed.
Select the content that you want to publish with your docs:
The initial values of all variables are published with your documentation, so make sure they don't contain sensitive information such as passwords or tokens.
Select a custom domain from the Custom domain dropdown list where you want to publish your documentation.
Select the appearance settings for your published docs. You can preview any changes you make in the sample layouts in this section before you publish your docs.
You can use different logos for each collection you publish. Logos must be 2 MB or less in size and must be in JPEG or PNG format. The logo can be any aspect ratio (square or rectangle.)
Add metadata to your documentation to make it more discoverable on the web.
To preview your documentation using the current settings, select Preview Documentation. The preview automatically updates as you change settings.
If Postman detects a possibly sensitive token or other secret, a warning appears at the top of the preview window. Postman also highlights the token so you can remove it from the documentation before publishing.
When you're finished changing settings, select Publish to publish your documentation.
Postman Free, Basic, and Professional plans - You can optionally select a public workspace to move the collection to. This makes the collection discoverable on the Postman API Network. When you're ready, select Publish. You can view your public documentation at the provided URL.
Postman Enterprise plans - Your Community Manager controls the Postman elements your team makes public. Enter a note for your Community Manager and select Request Publish. When your request is approved, you'll receive an email notification with a link to the public documentation. To retract your publish request, change the pending publication settings and select Retract request.
To share your public documentation, share the published URL with your team members, other users, or the community. If you have forgotten the URL of your published documentation, you can get it at any time.
If your collection is in a public workspace, others can search for and find your collection on the Postman API Network, along with its documentation. If you haven't already moved your collection to a public workspace, you can do so at any time by changing the publication settings.
By sharing your documentation with the Postman API Network, you increase the visibility of your API to a wider range of consumers in the Postman community. Learn more about public workspaces.
Change the publication settings for your documentation to update your documentation's look or make your collection public. You can change the publication settings at any time after publishing your documentation.
Select Collections in the sidebar.
Select the more actions icon next to a collection with published docs, and then select View Documentation.
Select Published at the upper right, and then select Edit published documentation.
Select Edit settings, and then change the publication settings as needed.
Select Save and republish.
If you no longer want your documentation to be publicly available, you can unpublish it.
If you change your mind, you can publish your documentation again at any time.
Last modified: 2024/08/02
Additional resources
Videos
Blog posts
Case Studies