GitBook Integration
Import documentation from your GitBook spaces to train your SiteGPT chatbot. Perfect for teams using GitBook for product documentation, API references, and user guides.Prerequisites
- A GitBook account with at least one published space
- Read access to the spaces you want to import
- Owner or Editor permissions on the SiteGPT chatbot
Connecting GitBook
Authenticate
Click Connect GitBook and sign in with your GitBook credentials. Grant SiteGPT permission to read your documentation.
Select Content
Browse your GitBook organization and select:
- Entire spaces
- Specific pages or sections
- Multiple spaces from the same organization
What Gets Imported
| Content Type | Included |
|---|---|
| Page text | ✅ |
| Headings & structure | ✅ |
| Code blocks | ✅ |
| Tables | ✅ |
| API references | ✅ |
| Embedded files | ✅ |
| Images | ❌ (alt text only) |
GitBook’s content blocks (hints, tabs, cards) are converted to plain text while preserving their content.
Best Practices
Organize for Import
Structure your GitBook documentation with clear sections:- Getting Started: Onboarding and setup guides
- Features: Product capabilities explained
- API Reference: Technical documentation
- FAQ: Common questions and answers
Keep Content Current
- Re-import after updates: Sync your GitBook content after publishing changes
- Version control: If using GitBook’s Git sync, ensure main branch is up to date
- Clean up drafts: Only published content is imported
What to Include
Good Content for Training
Good Content for Training
- Product documentation
- User guides and tutorials
- API documentation
- FAQ sections
- Troubleshooting guides
Content to Avoid
Content to Avoid
- Internal-only documentation
- Changelog or release notes (unless relevant to support)
- Very technical API specs (may confuse general queries)
Troubleshooting
Spaces not appearing
Spaces not appearing
- Verify the space is published (not draft-only)
- Check that you have read access to the space
- Ensure the space is part of an organization you’re connected to
Import fails
Import fails
- Try importing fewer pages at once
- Check for pages with very large embedded content
- Verify your GitBook connection is still valid
Content formatting issues
Content formatting issues
- Complex GitBook blocks are simplified to text
- Interactive elements (tabs, accordions) show all content
- Embedded third-party content may not import
GitBook Alternatives
If you can’t connect directly to GitBook, you can also:- Export as PDF: Download your GitBook as PDF and upload to SiteGPT
- Use public URL: If your GitBook is public, add it as a website data source
- Markdown export: Export pages as markdown and upload