Create a new article

Article creation guide

To create a new article:

  1. Navigate to the category where you want to create the article.
  2. Select + Add Article.
  3. Enter a title for your article in the Article Title field.
  4. Select how you want to create the article. Some of these trigger further steps. The options are:
    • New article from scratch
    • Create from template: when you select this, KnowledgeOwl displays the Choose a Template Article dropdown. This lists all articles that are set as templates. Select the template you want to use. This creates a one-off copy of the template. There is no ongoing link between the template and the new article, so updates to the template do not affect the article.
    • Copy from existing: when you select this, KnowledgeOwl displays options to browse for an article by title, in any of your knowledge bases. Select a knowledge base, then start typing the title of the article you want to copy.
    • Share content from an existing article: the steps for this are similar to copying from an existing article. However, we recommend following the detailed instructions in the Share articles between categories and knowledge bases section, to ensure you know exactly how the content syncing works.
  5. Select Add and Edit to create the article and open the editor.

Create a new article from scratch

Selecting this option during article creation gives you a blank article. Refer to the Article creation guide for step-by-step instructions.

Article templates

Create an article from a template

You can choose to create a new article using another article as a template or starting point. It's another way to copy an existing article as a starting point so you don't have to start from scratch. This creates a one-off copy of the template. There is no ongoing link between the template and the new article, so updates to the template do not affect the article. Refer to the Article creation guide for step-by-step instructions.

Create a template from an article

You can turn any article into a template. 

  1. Open the article for editing.
  2. In the Internal Flags menu section, select Template - Quickly create new articles from this content.
    Screenshot of the article settings menu. The Template checkbox is highlighted.
  3. Select Save.

Structure template (sample)

This is a sample template for providing style and structure guidance. Refer to Create from template for information on creating articles using templates. You could create a template article with a setup similar to this sample, in order to provide guidance to your writers.

When thinking about what to include in your template, consider using a style guide.


Heading 2: Major topic

Body paragraph. Anything not in a list should be formatted like this. References to specific menu/navigation options should be capitalized, e.g.: Click on Settings > Style. In general, avoid using italics. Use bold only when it feels necessary.

Heading 3: Subheading for Heading 2

Heading 4: You should really consider restructuring your content and breaking it up

Numbered Lists:

  1. Always use numbered lists for step-by-step instructions.
  2. Step 1. Each step should be a single, clear step in the process. 
  3. Screenshots should be included in the list item so that they are properly indented. Include arrows or callouts using branded color palette. Use rounded square for shape call-outs.
  4. Sample code should be included in the list item so that it is properly indented:
    <a href="#">Here's some sample code in just preformatted style</a>

Bullet point lists:

  • Always use bullet point lists for lists rather than instructions
  • Think carefully about list length. Longer lists are harder to process; it's recommended to keep bulleted lists to about seven items. Read more about making your content brain friendly.
  • Good use of bold: when you have a bullet point list with items that also have descriptions
  • Keep your list consistent; list items should either all end in periods or should have no periods
  • Screenshots relevant to the list should be within the bulleted list item:

Pro Tip: Use Alert Success for things that could be classified as tips or "Pro Tips". These look better if they start with a bolded phrase.

Note: Use Alert Info for useful notes and asides. These aren't tips; they're a note or point that you want to call attention to.

Warning: Use Alert Danger for things that are destructive, permanent, or otherwise dangerous. If making a change or not following this step is going to cause disaster and chaos, tell people!

Copy an existing article

You can copy an existing article from any of your knowledge bases, to use as a starting point for your article. Unlike the share content, copying an article does not create a link between the two articles. Any changes you make in the new article will not affect the old article.

Refer to the Article creation guide for step-by-step instructions.

Share articles between categories and knowledge bases

You can use a single article in multiple categories and across knowledge bases. The content (body) of the article as well as all versions stay in sync across all shared articles. Each article can have its own title, restrictions, and callouts. These are called shared content articles.

Updating the content of any of the articles updates the content of all of them.

To share an existing article in another category or knowledge base:

  1. On the Articles page, navigate to the location where you wish to add the article.
  2. Select + Add Article.
  3. Select Share content from an existing article.
  4. Additional options appear below. If you have multiple knowledge bases, the knowledge base you're currently in is selected, but you can select a different knowledge base's articles to search.
  5. Next, in the Search for existing article field, start typing part of the article's name. This is an exact match search, and the dropdown will offer you articles that match your search.
  6. Once the article you wish to share content with appears, select it.
  7. This will copy the Article Title field at the top, based on the shared content article's title. You can change this if you wish.
  8. Once you're done selecting the article and editing the title (if needed), click the Add and Edit button in the lower right to complete the content sharing.
  9. This will open the new, shared content article. It will have all the content of the article you selected when you created it. It will open in Draft mode and will have a banner reminding you that this content is linked to an article in another location. Use the links in this banner to quickly navigate to the synced content article or the knowledge base where this is located.
    Sample warning message for a child shared content article
  10. You are now free to make any other changes as necessary to the article. Remember that any changes to the article body will be updated in all shared content articles.

For information on what gets shared and how, see Shared content articles.

URL redirect article

What if the content you'd like to include in your knowledge base isn't IN your knowledge base? Maybe you'd like to reference the page of another site, or a press packet your PR department has put together.

You can set up both categories and articles as URL redirects. For articles, this means you can administer the article as an article (restrict it to groups, restrict editing to teams, use the article call-outs, assign related articles) but when someone clicks on the title of the article or navigates to the URL, they'll be redirected to the URL you set up, instead.

URL redirects can be great when used with:

  • Links to external sites/files you don't want or can't move into KnowledgeOwl
  • Links to files stored within KnowledgeOwl, where you want the file to open directly (See the KnowledgeOwl W-9 for an example of this type!)

You can create a new article as a URL redirect or convert an existing article to be a URL redirect. To do so:

  1. Check the URL Redirect box in the righthand menu of the article editor:
  2. Once checked, this will add a section between the full article title and the editor where you can add the URL you'd like to redirect to:
  3. Now, add the URL you'd like to redirect to.
    1. For external URLs, type or paste the URL you'd like to use into the Redirect URL field. Here, we're redirecting to the International Owl Center's Owl Glossary page:
      Sample external redirect URL
    2. To redirect to a file uploaded to KnowledgeOwl (or to directly upload a file to KnowledgeOwl to redirect to), click the Redirect to File button:
      Click the Redirect to File button
      This will open an Add file from Library pop-up where you can select the file you'd like to insert. Browse or search for the file. (Or click Upload New File to add a new one.) Click on it to select it, then click the Insert File button in the lower right.
      Select the file you'd like to redirect to and click Insert File
      The URL of the file will be added:
      Redirect article with a KO file URL used
  4. Set whether you'd like the redirect link to open in a new tab or in the same tab. (Open link in new tab is used by default.)
  5. Save your article.

URL redirect articles do not work within categories that use the Override Article Links setting. This is because the override gets applied before the URL redirect.