> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.crisp.chat/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to include a PDF in Knowledge Base articles

*Embed a PDF in a Crisp Knowledge Base article by loading it through a frame.*

A PDF can be displayed inside an article with the Crisp `${frame}` syntax. The PDF must be reachable from a public URL so the viewer can load it for your visitors.

---

# ${color}[#0080dd](Prepare the PDF URL)

Before embedding the PDF, make sure the file is publicly accessible. If the PDF is hosted behind a login or a private link, visitors may not be able to open it inside the article.

**Use this Google Docs viewer format:**
```text
https://docs.google.com/viewerng/viewer?url=https://A_LINK_TO_YOUR_PDF&embedded=true
```

|| If your PDF URL contains spaces or special characters, encode the URL before placing it in the `url=` parameter.

---

# ${color}[#0080dd](Embed the PDF in Crisp)

Paste the viewer URL into the Crisp frame syntax.

```markdown
${frame}[PDF](https://docs.google.com/viewerng/viewer?url=https://A_LINK_TO_YOUR_PDF&embedded=true)
```

For example:

```markdown
${frame}[PDF](https://docs.google.com/viewerng/viewer?url=https://infolab.stanford.edu/pub/papers/google.pdf&embedded=true)
```

---

# ${color}[#0080dd](Example)

${frame}[PDF](https://docs.google.com/viewerng/viewer?url=https://infolab.stanford.edu/pub/papers/google.pdf&embedded=true)

---

# ${color}[#0080dd](Frequently Asked Questions)

*Still have questions which were not covered in this article? Here is a collection of the most frequently asked questions on this topic.*

###### ${color}[#F08820](Can I embed a private PDF?)

**Only if the visitor has access to it.** For most Knowledge Base use cases, the PDF should be available from a public URL; otherwise the frame may show an access error.

###### ${color}[#F08820](Why does the PDF not load in the article?)

**Check that the PDF URL is public, uses HTTPS, and is correctly encoded.** Then test the final frame from the article preview or published Knowledge Base page.
