Learn how to Publish your apps and integrations publicly and privately
When you're ready to publish your integration, you're able to publish it for use within GitBook.
To publish your integration, you will need to use the GitBook CLI. By running the
publishcommand, it will publish your integration to GitBook using the options defined in your
It's required to have a
gitbook-manifest.yamlfile to publish an integration.
By default, it will publish your integration to the organization specified in your integration's
gitbook-manifest.yamlfile. Keep in mind, that only users within this organization will be able to install it.
A unique name for your integration. (e.g. slack)
The title of your integration. (e.g. Slack)
The description for your integration.
The visibility for your integration. Defaults to
private. When set to
private, only members of the organization that owns the integration are able to see or install the integration into a space.
Set the visibility to
unlistedin order to share your integration install link with anyone.
A list of scopes your integration allows. The following scopes are accepted:
After successfully publishing your integration, you will be able to find and install your integration via the link returned in your console.
Keep in mind, that only users within your organization will be able to find or install your integration in their spaces.
If you're interested in sharing or testing your integration with users outside, you'll need to update the
visibilitykey in your integration's
visibility: unlistedwill allow your integration to be installed in organizations outside of the one that has published it. Make sure you republish your integration using
gitbook publishafter updating this key locally.
In order for your integration to be listed on our Marketplace, you will need to go through our submission process.