Write an Article

Long-form content solutions that provide an alternate way to write content.

Written by Loren Alldrin
Updated over a week ago

Tags | Articles |

Applies to: Business

Enterprise users can access their documentation here. Find your plan.

Articles provide a long-form content solution within Teams. In addition to questions and answers, users will now be able to create an article to proactively share knowledge with fellow team members. Articles will show up in search results along with Q&A content.

Create an article

Click on the Articles in the left navigation and then click on Create a new article. You will then be taken a page for creating your new article.

Start by giving your article an informative title and pick from one of the available article types. These article types give your team members a general idea of the type of content within each article. Next, pick at least one tag to categorize your article. You can add up to four tags.

Once you’ve added your tags, it’s time to write the article. Try copy-pasting existing documents you have on other platforms right into the editor to save time and automatically convert them into Markdown. Upload images, use lists, add code snippets, and much more. If you link to questions on your team within the article, those questions will also be listed on the sidebar to the right of your article’s content.

When you’re done, click Save and your article will be published.

Utilize feedback

Once an article is published, team members can provide feedback to the author and editor(s) of the article, as well as highlight its usefulness to the rest of the team.

  • Click the green upvote to mark an article as useful. The author will receive additional reputation with each upvote.

  • Click the blue light bulb to provide feedback to the author of the article. You will be presented with options to indicate how the article can be improved.

Once a user submits feedback, the author will be notified and they will be able to address feedback as needed. If the author clicks on the feedback notification or edits the article, they’ll see the feedback in the right sidebar. Article authors and editors can click the checkmark to resolve active feedback items.

Organize articles

Besides browsing the articles page, your articles can be found through search and organized as part of collections. When viewing an article, you can even quickly add it to a collection by clicking Add this article to a collection in the right sidebar, or add them in bulk from the collection itself.

Filter and find articles

From within the Articles section, you can filter the results with the available options at the top of the page. You can also search for articles alongside usual Q&A content using the search box in the top bar. There are a couple article-specific search features that can make it easier to find them:

  • Search for specific article types in the same way you would search for tags: [knowledge-article], [how-to-guide], [announcement], and [policy].

  • Search for only article (and exclude Q&A) using the is:article operator.

Articles will also be included in the For You section and e-mail notifications.

Grant edit permissions

By default, the author and any admins on a team can edit an article, including viewing and addressing feedback. Grant additional editing rights to specific team members by clicking on Permission settings when creating or editing an article.

Need help? Submit an issue or question through our support portal.

Did this answer your question?