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

# Creating Articles

> Create knowledge base articles manually, import from files, or let the AI generate them.

There are multiple ways to add articles to your knowledge base. Click the **New Article** dropdown on the Knowledge Base page to get started.

## Manual Creation

Create an article from scratch using the built-in rich text editor.

<Steps>
  <Step title="Click New Article > Create new article">
    This opens the article editor.
  </Step>

  <Step title="Enter a title">
    Give your article a clear, descriptive title. The title helps the AI agent find the article when investigating tickets.
  </Step>

  <Step title="Write the content">
    Use the rich text editor to write your article. You can use formatting like headings, lists, code blocks, and links.
  </Step>

  <Step title="Save">
    Click **Save** to publish the article. It will immediately be available to the AI agent.
  </Step>
</Steps>

<Tip>
  Write articles as if you're explaining a feature or troubleshooting step to a colleague. The AI agent performs best with clear, well-structured content.
</Tip>

## Importing from Files

Upload existing documentation files to create knowledge base articles.

<Steps>
  <Step title="Click New Article > Import from file">
    This opens the file upload dialog.
  </Step>

  <Step title="Select a file">
    Choose a file from your computer.
  </Step>

  <Step title="Add a title">
    Enter a title for the article. The file name is used as a suggestion.
  </Step>

  <Step title="Upload">
    Click **Upload** to process the file and create the article.
  </Step>
</Steps>

### Supported File Formats

| Format                   | Extensions      |
| ------------------------ | --------------- |
| PDF                      | `.pdf`          |
| Markdown                 | `.md`           |
| Plain Text               | `.txt`          |
| Word                     | `.docx`         |
| Excel                    | `.xlsx`, `.xls` |
| OpenDocument Spreadsheet | `.ods`          |
| OpenDocument Text        | `.odt`          |
| CSV / TSV                | `.csv`, `.tsv`  |
| HTML                     | `.html`, `.htm` |
| Rich Text                | `.rtf`          |
| JSON                     | `.json`         |

## AI-Generated Articles

Decimal can automatically create knowledge base articles from two sources:

### From Support Ticket Resolutions

When the AI agent resolves a support ticket, you can save the resolution as a knowledge base article:

1. Open a completed ticket in the Support page
2. Click the **Save to Knowledge Base** button in the agent response panel
3. The article is created with the resolution content
   These articles are created with an **In Review** status, prompting a team member to verify the content before it's fully published.

### From Playground Answers

When the Playground produces a useful answer, you can save it as a knowledge base article directly from the Playground interface.

## Notion Sync

If you've connected the [Notion integration](/integrations/notion), articles from your selected Notion databases are automatically synced to your knowledge base. See the [Notion integration page](/integrations/notion) for setup instructions.