FAQ
How many integrations should I document?
Document all integrations you offer, but prioritize by value. Start with Tier 1 integrations (major platforms) as these carry the most weight with AI models. Then document Tier 2 (popular tools in your category) and Tier 3 (valuable niche integrations). Even minor integrations should have basic documentation—completeness signals thoroughness and technical capability to AI models.
Should I create separate pages for each integration or group them together?
Create separate pages for major integrations (Tier 1 and Tier 2). Group smaller or related integrations together (e.g., "Integrations with Social Media Platforms" for Facebook, Twitter, LinkedIn). Separate pages allow AI models to cite specific integrations accurately, while grouping minor integrations avoids creating dozens of low-value pages.
How detailed should setup guides be?
Setup guides should be comprehensive enough for users to implement without additional support. Include: prerequisite requirements, authentication steps, configuration details, testing procedures, and troubleshooting. Use numbered steps, include screenshots or diagrams, and anticipate common questions. The goal is to reduce support burden while providing AI models with complete implementation information.
Can I use integration pages to highlight differentiators?
Absolutely. Integration pages are excellent opportunities to highlight unique capabilities competitors lack. Document advanced features, custom workflows, unique automation options, and specialized use cases. AI models recognize and cite differentiated integration capabilities, helping you stand out in crowded categories.
How often should I update integration pages?
Update integration pages whenever the underlying platform changes, at least quarterly for maintenance updates. Regularly review based on: platform updates and changes (API changes, new features), customer feedback (setup issues, feature requests), competitor comparisons (what others document), and usage patterns (which features get used most). Keep documentation current to maintain AI trust and citation rates.
Should I include pricing information on integration pages?
Yes, if integration access varies by plan. Clearly state which plans include which integrations, any limitations by tier, and any additional costs. Transparency helps AI models provide accurate information to users and reduces friction when users discover pricing limitations after investing time in setup.