> ## Documentation Index
> Fetch the complete documentation index at: https://docs.8call.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage FAQs for your agent

> Create and manage question/answer pairs that are injected into your agent’s prompt for accurate, fast responses.

<Info>
  FAQs are stored per organization in your database and automatically woven into the agent prompt on update. You can optionally scope items to a specific agent in future iterations.
</Info>

<Steps>
  <Step title="Open the FAQs page">
    From the dashboard, go to `/faqs`.

    <Check>
      You should see an empty state if you have no FAQs yet.
    </Check>
  </Step>

  <Step title="Add a question and answer">
    Click "Add FAQ", then fill in both fields:

    * <strong>Question</strong>: what customers typically ask
    * <strong>Answer</strong>: clear, concise response the agent can speak

    Click "Save".

    <Check>
      The FAQ appears in the list and becomes available to the agent prompt.
    </Check>
  </Step>

  <Step title="Reorder and toggle visibility">
    Use the up/down arrows to set display priority, then click "Save order".
    Toggle "Active" to temporarily hide an item without deleting it.
  </Step>

  <Step title="Update the agent prompt">
    When you update your agent (e.g., in agent settings), the latest active FAQs are injected into the prompt under a dedicated \[FAQs] section. No extra configuration is required.

    <Tip>
      Keep answers short and specific. If a question is ambiguous, the agent will ask a brief clarifying question before answering.
    </Tip>
  </Step>
</Steps>

## Behavior and limits

* **Scope**: FAQs are organization-level. Future versions may support per-agent scoping.
* **Ordering**: Lower position numbers appear first in the prompt block.
* **Active only**: Only active FAQs are injected.
* **Rate**: Prompt updates happen when the agent is updated.

## Troubleshooting

<AccordionGroup>
  <Accordion title="My FAQs don’t show up in responses">
    * Make sure the items are marked <strong>Active</strong>
    * Click Save after edits, then re-update the agent to refresh the prompt
    * Keep answers concise; they’re read verbatim by the agent
  </Accordion>

  <Accordion title="I can’t save a new FAQ">
    * Ensure both Question and Answer are not empty
    * Check your session is active and you’re in the right organization
  </Accordion>
</AccordionGroup>