Links

Insights

Learn about the native insights GitBook provides for your public documentation.
You can measure and improve your documentation by checking how your pages are performing and which keywords are used when searching through your documentation.
Permissions
Administrators and creators can view the insights panel.

The insights panel

When inside of a space, click on insights in the space sub-navigation to open the insights panel. You'll see two tabs: pages and searches.

Pages

Traffic

This shows a summary of visits to your space across all pages. You can view daily, weekly, or monthly traffic — monthly is the default. A bar chart plots that traffic over time.

Pages

For each page in the space, you can see a count of all views. This is the total number of views since the page was published. If page rating is enabled, you can also see how many people have left feedback on each page and the average feedback rating. Hover over the average rating to see further details.
Click download CSV if you'd like to use or analyse this data further outside of GitBook, and a .csv file will be downloaded to your device.
Switch to the search tab to take a look at which terms visitors are searching for within the space. You can view these search terms for the past week, month, or year — and again, the month is the default setting.
The information here can be helpful for informing your content architecture, making certain parts of your documentation easier to find without search, or adding additional content to existing pages based on what your visitors are searching for.
Click download CSV if you'd like to use or analyse this data further outside of GitBook, and a .csv file will be downloaded to your device.

More insightful insights

GitBook's insights are intended to provide you with a brief overview, but you might want to go deeper by integrating with Google Analytics.
GitBook default insights offer a quick overview of page views. To take a deeper look into your readers' behavior, you should take a look at our Google Analytics integration.

Data sampling

In data analysis, sampling is the practice of analyzing a subset of all data in order to uncover the meaningful information in the larger data set. For example, if you wanted to estimate the number of trees in a 100-acre area where the distribution of trees was fairly uniform, you could count the number of trees in 1 acre and multiply by 100, or count the trees in a half acre and multiply by 200 to get an accurate representation of the entire 100 acres.
We apply session sampling to insights data in order to provide accurate reports in a timely fashion. The direct consequence is no page views are shown for new spaces or spaces with a low number of page views.