Writing guide for Knowledge Base articles
This Mozilla Support Document Guide includes picking a good title, writing a search summary, organizing your article and a style guide.
About the Knowledge Base
Learn about the Mozilla Support (SUMO) Knowledge Base and how it works.
Markup cheat sheet
This is a list of the most commonly used wiki markup in support articles.
How to contribute to the Knowledge Base
Learn how you can contribute to Mozilla Support by writing or improving support articles.
Add screencasts to Knowledge Base articles
How to add a video or animation of what's displayed on a computer screen to a Knowledge Base article.
Improve the Knowledge Base
Help improve the Mozilla Support Knowledge Base by making revisions to existing articles or by creating new articles.
How to use "For" tags
Learn how to use “for” markup in Mozilla Support articles, to show content for different operating systems and product versions
Article review guidelines for KB reviewers
Guidelines for reviewing KB articles including revision levels, feedback for editors and 'ready for localization' status
Technical writing program
This is the description of the SUMO technical writing program
When and how to use keywords to improve an article's search ranking
The keywords field in an article can be used to improve search results. It should be used only under specific circumstances though as misuse can hurt search.
Anatomy of a Knowledge Base article
This article explains the different parts of a support article, such as this search summary that tells you what an article is about.
Create a new Knowledge Base article
Guidelines and a template for creating a new article.
How to make screenshots
Learn how to take screenshots on Windows, macOS, Linux, iOS and Android to enhance your Knowledge Base articles with clear visuals.
Add images and screenshots to Knowledge Base articles
Elevate your Knowledge Base contributions with the power of visuals. Learn how to effectively integrate images into your articles.
Submit a minor edit or update to a Knowledge Base article
Learn how to submit a minor edit or update to a Mozilla Support Knowledge Base article.
Article discussion forums
Discuss articles with other Mozilla Support contributors and team members.
Minor vs major changes
Learn the difference between minor edits and major updates to Mozilla Support Knowledge Base articles
Using the Knowledge Base Dashboard
Learn to use the Knowledge Base Dashboard to view a list of Mozilla Support articles.
Best practices for creating new video tutorials
This article provides a series of best practices so that you can create high-quality video tutorials to better serve users using Mozilla's products.
How to obtain a shortened mzl.la link
This article explains how to obtain a shortened mzl.la link
How to stay updated with Firefox release
Stay on top of release updates and trending issues
Editorial guidelines for Mozilla accounts
The goal of these guidelines is to ensure we're talking about Mozilla accounts consistently across all of our products.
Firefox version support policy for Knowledge Base content
Learn about SUMO's version support policy for Firefox, focusing on the latest, previous and ESR versions to keep content relevant.
How to submit a SUMO Knowledge Base content request
Learn how to submit a request to the SUMO staff content team and contributors.
Best practices to use GIFs in KB articles
Use animated GIF images in KB articles, to reduce cognitive load and improve user experience effectively. Learn more.
How to create an in-product, stable link
Use stable URLs instead of direct SUMO links in product UI to prevent broken links when articles change.
Understand the article review process
Learn about the review process at Mozilla Support, when you submit an edit to a Knowledge Base article
Content maintenance and management
Learn more about content maintenance in Mozilla Support, also known as SUMO (short for SUpport.MOzilla.org)
Contributor assignments for content requests
Learn more about contributor assignments on content requests
Contributor access, communication and escalation channels
Learn more about access, communication and escalation channels for Mozilla Support contributors and staff
Article Metadata and how to edit
This guide explains how fill out the description for a new KB article and how reviewers can edit the metadata after the article is approved