Skip to main content

Custom Answers

Kapa provides a Custom Answers integration that allows you to create and manage question-answer pairs directly within the Kapa platform. This integration is different from others as it doesn't pull data from external sources but instead lets you add custom information quickly and easily.

Prerequisites​

  • A Kapa account with access to the Sources section
  • Prepared question-answer pairs you'd like to add

Data ingested​

When you create Custom Answers in Kapa, the following data is stored:

  • Question text (exactly as provided)
  • Answer text (exactly as provided)
  • Creation and modification timestamps

Setup​

  1. Go to the Sources section on the Kapa platform
  2. Click on Add new source
  3. Enter a name for your source
  4. Select Custom Answer and click Continue
  5. Click on the Add New button
  6. Enter the question in the "Question" field
  7. Provide the corresponding answer in the "Answer" field
  8. Click Save to add the pair to your collection

Best practices​

When to use Custom Answers​

  • Specific responses: Questions that require precise, controlled answers
  • Temporary fixes: Quick solutions while proper documentation is being developed
  • Edge cases: Specific information that doesn't fit well within your main documentation

When not to use Custom Answers​

In general, Custom Answers should be used sparingly. You should always prefer to update or expand your regular sources when possible.

Avoid using Custom Answers for:

  • Information that changes frequently: Content requiring regular updates is better maintained in external systems with proper versioning
  • Product features/functionality: These should be documented in proper documentation sources that follow your development lifecycle
  • Large volumes of content: If you need more than 20-30 Q&A pairs, maintenance becomes unwieldy without proper content management tools

Format tips​

  • Keep questions natural and conversational
  • Include variations of the same question when appropriate
  • Provide comprehensive but concise answers
  • Include links to relevant documentation or resources for additional context
  • Update answers regularly to ensure accuracy

Troubleshooting​

  • Answer not appearing: Ensure the user's question is similar enough to your stored question
  • Multiple answers showing: You may have overlap between custom answers; consider consolidating
  • Missing information: Custom answers are static; regularly review and update content as needed