# FAQs

> Write question-and-answer pairs in the dashboard or manage them by API with your own keys, in any of your store's languages.

Source: https://shopassist.coec.dk/docs/knowledge-base/faqs · Updated 2026-10-01

FAQs are the fastest way to teach the assistant something specific. Write them in **Knowledge → FAQs**: a question (up to 300 characters), an answer (up to 4,000) and a language.

Good FAQs are short and specific: "Do you ship to Norway?" with the actual answer, rather than a general shipping text. The assistant matches questions by meaning, so you don't need every wording.

## Manage FAQs by API [#api]

Keep FAQs in your own system and upsert them by your own key (up to 128 characters):

`PUT /v1/stores/{store_id}/knowledge/faqs/{external_ref}` (scope `knowledge:write`)

`DELETE /v1/stores/{store_id}/knowledge/faqs/{external_ref}` (scope `knowledge:write`)

```bash
curl -X PUT "https://api.shopassist.coec.dk/v1/stores/sto_.../knowledge/faqs/shipping-norway" \
  -H "Authorization: Bearer $SHOPASSIST_API_KEY" -H "Content-Type: application/json" \
  -d '{"question":"Do you ship to Norway?","answer":"Yes, in 3–5 business days. Duties are paid on delivery.","locale":"en"}'
```

FAQs from the API are checked like every other document; instruction-like text goes to the [review queue](/docs/knowledge-base/review-queue).