YouTrack Server 2026.2 Help

Create an Article

Whenever you have a piece of information that you want to share with users who have the appropriate level of access in a particular project, you can add an article to the knowledge base.

When you add an article to the knowledge base, it is created as a draft. Your drafts are only available to you, even when the visibility restrictions for the article are undefined.

This means that you can take all the time you need to polish the article to perfection before you publish and share it with a larger audience.

If you're writing the first knowledge base article for a project, the project name is not yet displayed in the knowledge base navigation menu. Click New Article in the application header. After writing the draft, click Select project and publish to locate the project name in the list.

Once you have one or more articles in a project, whether published or in draft form, you can add articles and sub-articles using the controls in the table of contents in the side panel.

To create your first article in a project:

  1. From the main navigation menu, select Knowledge Base.

  2. Click the New article button, which is located in the header.

    Knowledge Base page with the New article button in the header.
    • The page displays a new, untitled draft.

    • The article draft is listed in the Drafts section in the table of contents.

  3. Give your article a title by typing directly into the Title field.

  4. Enter or paste the article content into the content editor.

  5. When ready, click Select project and publish.

    • Select a project from the drop-down menu.

    Article draft with Select project and publish available below Similar Articles.

Once you have one or more articles in a project, whether published or in draft form, you can add articles and sub-articles using the controls in the table of contents in the side panel.

  • To add subsequent articles to a project, click the plus icon to the right of the project name.

    Project table of contents with Add an article to the Demo Project highlighted.
  • To add sub-articles to an existing article, click the plus icon to the right of the article title.

    Article table of contents with Add sub-article to this article highlighted.
  • If the article already has a sub-article published, you can use the Add sub-article link in the Sub-articles section at the bottom of the article.

    Published article with Add sub-article available in the Sub-articles section.
22 July 2026