# Creating a Knowledge Base Article

https://docs.wisecp.com/es/creating-a-knowledge-base-article

Write a help article in every site language and publish it on your website from a single form.

## Opening the Screen

Go to `{admin}/knowledgebase` and click the **Create Article** button. The form opens at `{admin}/knowledgebase/add`.

To change an article you already have, open the same list, then open the row menu at the end of its line and choose **Edit**. The edit form carries the same fields. The address in the URL column opens the public page in a new tab instead. If the menu entry is missing, turn on **Knowledge Base** under Settings, General, Advanced.

## What Is on the Screen

A language tab strip runs across the top of the form. Title, link structure, content, tags and the SEO fields belong to the language you picked. Switch tabs to fill in the next language.

Under those fields you decide where the article is filed and who sees it: category, sort order, two visibility switches, status and an optional background image. The last card is **Search Engine Optimization (SEO)**. The **Create** button at the bottom saves the whole form at once, for all languages.

## Fields

### Language Fields

- **Title**: The name of the article. Required in every language.
- **Link Structure**: The web address of the article. Leave it alone and it comes from the title.
- **Content**: The body of the article. The editor handles headings, lists, links, tables and images. JavaScript and form tags are removed when you save. Embedded frames are kept only from Google Maps, OpenStreetMap, Yandex Maps, YouTube and Vimeo.
- **Tags**: Helps the article turn up in the knowledge base search on your website. That search covers the title, content and tags. Optional.

### Publishing Options

- **Category**: The category the article belongs to. Default: **None**. Subcategories carry a dash in front of the name.
- **Sort Order**: Position of the article in the list. Smaller numbers come first. Optional.
- **Registered Clients Only**: When ticked, the article stays out of the website lists, the search results and the article page. The help text on the screen says only registered clients can see it. In fact nobody sees it, registered clients included. The box takes the article off the website altogether. Default: off.
- **Hide Sidebar**: Hides the sidebar and gives the article the full page width. Default: off.
- **Status**: An article appears on the website while this box is ticked. Default: ticked.
- **Background Image**: Header image of the article page. 1920 x 400px, up to 2MB, JPG, PNG, SVG or WebP. Optional.

### SEO Card

- **Enable SEO**: Switch for the two search engine fields below. Its position is not stored on this screen, so the form opens with it on every time.
- **Page Title**: The headline search engines show. One per language.
- **Meta Description**: The short summary under the headline in search results. One per language.

## Tasks

### Write an article

1. Fill in **Title** and **Content** for the language shown in the tab strip.
2. Pick a **Category**, then check **Status** and **Registered Clients Only**.
3. Click the **Create** button at the bottom of the form.

The article is saved and you land back on the knowledge base list.

### Fill in another language

1. Click the language you want in the tab strip at the top of the form.
2. Fill in **Title** and **Content** again. The other fields stay shared.
3. Click **Create** (or **Save** while editing).

Every language you filled in is saved in one go.

### Change the web address

1. In the **Link Structure** field, click the pencil button, **Change the URL**.
2. Type the new address and click the same button again; it now carries a check mark. Enter saves it too.
3. Click **Create** (or **Save** while editing) to save the article itself.

The article answers at the new address. Repeat this for each language tab.

## Things to Watch

> **A title is needed in every language**
> 
> Nothing is saved while one language tab has an empty title. The warning shows the language code, so switch to that tab and fill it in.

> **Two articles cannot share an address**
> 
> If the link structure is already taken in that language, the form refuses to save. Pick a different address.

> **Changing the address breaks old links**
> 
> Visitors and search engines keep the old address. After you change it, the previous address answers with a not found page.

> **Do not save with the SEO switch off**
> 
> Saving while **Enable SEO** is off writes an empty Page Title and Meta Description. The values you entered before are lost.

## Required Privileges

Writing, editing and saving an article needs `KNOWLEDGEBASE_OPERATION`. Without it the screen answers with an access warning.

## Related Articles

- [Knowledge Base Articles](https://docs.wisecp.com/en/knowledge-base-articles)
- [Creating a Knowledge Base Category](https://docs.wisecp.com/en/creating-a-knowledge-base-category)
- [Knowledge Base Categories](https://docs.wisecp.com/en/knowledge-base-categories)