# Publish a docs site

Once you’ve finished writing, editing, or importing your content, you can publish your work to the web as a docs site. Your docs will be published on the web and available to your selected audience.

The content on your site comes from [spaces](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/creating-content/content-structure/space) in your organization. When you create a new docs site, you can create a new space, or link an existing one.

<figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FaTAoahHyizxbZzQ10kq9%2Fpublishing-documentation-publish-docs%402x.png?alt=media&#x26;token=7217e51d-8c38-45d5-95a2-f49cee149c5f" alt="A GitBook screenshot showing the docs sites homepage"><figcaption><p>GitBook's docs sites homepage.</p></figcaption></figure>

### Create a docs site

To create a docs site, click the plus **+** icon next to Docs site in the sidebar to launch the docs site wizard.

Give your site a name, choose a starting point for your content, and select whether you want to publish your site now or later.

If you already have content in a space that you would like to use, you can create a docs site directly from that space by opening the space and clicking **Share** in the top-right corner of the window. Then choosing **Publish as a docs site** from the share modal.

### Publish a docs site

By default, your site will be published publicly. You can change your site’s visibility in your [site’s settings](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/publishing-documentation/site-settings).

There are three primary options to choose from when publishing your site:

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-type="image">Cover image (dark)</th><th data-hidden data-type="image">Cover image (dark)</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th></tr></thead><tbody><tr><td><strong>Public</strong></td><td>Publish your docs publicly to the web.</td><td></td><td><a href="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FoilRMA6SHJfDUlmxzFSc%2FPublic.png?alt=media&#x26;token=79c5b78b-d5e1-4f13-9d87-ff449dbc16ab">25_12_12_public.png</a></td><td><a href="publish-a-docs-site/public-publishing">public-publishing</a></td><td><a href="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fjd69hIdmcyS7RbVe6tW8%2FPublic.png?alt=media&#x26;token=1a65de91-1101-4cb3-baaa-4f75c9049e72">25_12_12_public_1.png</a></td><td></td><td><a href="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fjd69hIdmcyS7RbVe6tW8%2FPublic.png?alt=media&#x26;token=1a65de91-1101-4cb3-baaa-4f75c9049e72">25_12_12_public_1.png</a></td></tr><tr><td><strong>Privately with share links</strong></td><td>Publish your docs with private share links.</td><td></td><td><a href="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Ffc0Pst5E74fYtiKz3Evt%2FShare%20links.png?alt=media&#x26;token=699b168a-ca2d-4752-9b28-7be032147e61">25_12_12_share_links_1.png</a></td><td><a href="publish-a-docs-site/share-links">share-links</a></td><td></td><td><a href="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FpSDF3ZEkFoC35xvrNtLo%2FShare%20links.png?alt=media&#x26;token=8decbb40-19a4-49ee-b629-7da186745dbd">25_12_12_share_links.png</a></td><td><a href="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FCS9dGgMUG2sLrcAjaRvw%2FShare%20links.png?alt=media&#x26;token=0cd92dec-e895-4f4a-93b0-6241f525b734">25_01_06_share_links@2x.png</a></td></tr><tr><td><strong>Authenticated Access</strong></td><td>Protect your published docs behind an OAuth sign in.</td><td></td><td><a href="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FvnW7XiU7dys1vIf7Hi6l%2FAuth%20access.png?alt=media&#x26;token=5edc9fab-f51f-4acb-a34c-ae16922f7e2f">25_12_10_auth_access_1.png</a></td><td><a href="authenticated-access">authenticated-access</a></td><td></td><td></td><td><a href="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fos97IAePIUcHI9MX5p3x%2FAuth%20access.png?alt=media&#x26;token=45ee74db-e185-4faf-9b8a-7c86e542b0c5">25_12_10_auth_access.png</a></td></tr></tbody></table>

### Delete or unpublish a docs site

To delete a docs site, you’ll need to open your site’s dashboard, then open [**Site settings**](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/site-settings#delete-site) from the top-right corner.

### Site permissions

Admins can manage site permissions directly from a docs site.

From the site’s **Overview** page, click **Share** in the top-right corner. You can also open **Settings** > **General** and click **Access** > **Manage permissions**.

You can also manage these settings from [Site settings](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/publishing-documentation/site-settings).

Setting a permission level on a site, for everyone, a team, or an individual user, determines their ability to administer or view the site. When spaces within the site are set to ***Inherited*** mode, these permissions are also propagated to those spaces.

The table below summarizes how each role maps to permissions on the site and how it propagates to spaces in ***Inherited*** mode.

| Permission level for spaces | Permissions on the site |
| --------------------------- | ----------------------- |
| Administrator               | Edit and see            |
| Creator                     | See                     |
| Reviewer                    | See                     |
| Editor                      | See                     |
| Commenter                   | See                     |
| Viewer                      | See                     |
| No access                   | Cannot see              |

{% hint style="info" %}
Spaces in ***Inherited*** mode inherit permissions from the organization or their parent collection, along with the site permissions and any local overrides.

Each member is assigned the highest role they have across these permission sources.
{% endhint %}
