Welcome to the official home of the WordPress Documentation Team.
This team is responsible for coordinating all documentation initiatives around WordPress, including the handbooks and other general wordsmithing across the WordPress project.
Want to get involved?
Start here to find out more about what we do and how to contribute:
Documentation Issue Tracker on GitHub: Submit any Documentation Team-related issues on GitHubGitHubGitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/
Weekly meetings
Join our discussions of documentation issues here on the blog and on Slack.
Spell out whole numbers from zero through nine, with exceptions as described in Numbers as numerals. Examples
three databases
zero percent
17 documents
15,493 entries
Use the spelled-out number when it starts a sentence. Example
Recommended: Twenty files were copied.
You can rewrite the sentence so that the number doesn’t start the sentence. Examples
Not recommended: 1500 records were cleared from the old directories.
Recommended: Freeing up some space in the old directories, almost 1500 records were cleared.
When a number is followed by another numeral, use a numeral for one and spell out the other. Examples
Recommended: The folder contains three 256-bit AES encrypted files.
Recommended: The folder contains 3 of the 256-bit AES encrypted files.
If one item requires a numeral, use numerals for all the other items of that type. Example
Recommended: One instance of the application runs on 2 cores, one on 4 cores, and the third one on 6 cores.
Spell out indefinite, casual, ambiguous, and rounded numbers. Examples
Recommended: Millions of users use WordPress.
Recommended: You can choose from tens of thousands of plugins from the PluginPluginA plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party Directory.
Spell out zero through nine and use numerals for 10 or greater for days, weeks, and other units of time. Examples
Use commas and decimal points as per American number formatting. Use commas in numbers having four or more digits, setting off groups of three digits left of the decimal point. Don’t use spaces, commas, or any separators to the right of the decimal point.
Use a period to denote a decimal point.
Examples
Not recommended: You can carry out a maximum of 1500000 transactions per month.
Recommended: You can carry out a maximum of 1,500,000 transactions per month.
Not recommended: The total cost may exceed $17000.
Not recommended: The total cost may exceed $17 000.
Recommended: The total cost may exceed $17,000.
Not recommended: Your account will be credited 0.079 635 credits every two hours.
Recommended: Your account will be credited 0.079635 credits every two hours.
For decimals less than 1, put a zero before the decimal point.
Example
Recommended: 0.54 square miles
When expressing measurements where the unit of measurement is spelled out, use the plural form when the quantity is a decimal fraction. Use the singular form of the unit only when the quantity is 1.
Express fractions as decimal numbers whenever possible, but expressing them as words or symbols as is acceptable. Don’t use slashes with fractions, as they may be difficult to comprehend. Using slashes with fractions could be misunderstood as alternatives or combinations. When expressing fractions as words, use a hyphen to link the numerator with the denominator, unless one of them is already hyphenated.
Denote percentages with the numeral and a percent sign (%) after it, without a space between them. Exception: If the percentage starts the sentence, then spell out both the number and the word percent.
Mention to the reader distinctly what country’s currency that you’re referring to. For example, the dollar sign ($) can be mistaken for US dollars, Canadian dollars, Australian dollars, and multiple other currencies. Use ISO defined country or region codes to depict international currencies, if possible.
When you’re referencing specific amounts of money, use the currency code, followed by the amount, with no space.
Example
Recommended: The non-profit organization was endowed with a USD1.5 million grant.
Capitalize the country or region, but lowercase the name of currencies.
Examples
US dollar
Indian rupee
Japanese yen
For US dollars, use the dollar sign at the beginning ($) of the currency. Use a comma to delineate the thousands place of whole currency; that is, use a comma in amounts that have four or more digits. Use a period to delineate whole currency and fractions of currency. Don’t use any punctuation or spaces to the right of the decimal.
Examples
Not recommended: You have $15.39,512 in usable credits.
Recommended: You have $15.39512 in usable credits.
Recommended: Monthly hosting plans start from $3.95 per website.
Not recommended: The total cost may exceed $17000.
Not recommended: The total cost may exceed $17 000.
Recommended: The total cost may exceed $17,000.
If it’s clear which currency you’re referring to, it’s acceptable to only use the symbol rather than the word or country code itself.
Use a lowercase x between the numerals in the dimensions, with no space between the numerals and the x. You can also use the multiplication sign (×). Use a space before and after the multiplication sign.
En dashes are generally used to indicate a range of numbers, the minus sign, or negative numbers. Although you can use en dashes for these purposes, you can also use hyphens or the word to for numerical ranges.
Use an en dash indicate a range of numbers such as values or dates. Don’t add spaces before and after the en dash or the hyphen.
Examples
Not recommended: The program was under active development from 2012 – 2017.
Recommended: The program was under active development from 2012–2017.
Recommended: Select a range from 10–60 px as the width of the button.
In general, don’t abbreviate thousand, million, and billion as K, M, and B or k, mn and bn. Spell out the word or denote the entire number. Using these abbreviations makes it difficult to comprehend for readers and translating content.
Examples
Not recommended: The non-profit organization was endowed with a $1.5M grant.
Not recommended: The non-profit organization was endowed with a $1.5 mn grant.
Recommended: The non-profit organization was endowed with a $1.5 million grant.
In some contexts, using the abbreviations may be more relevant or suited. If you use abbreviations, follow these guidelines:
Don’t put a space between the number and the abbreviation.
Capitalize K, M, and B. [review]
Add a noun to indicate what the number measures and to avoid confusion between kilo, or mega for example.
Use the decimal form of a number only if it saves space. For example, 3.67K uses the same number of characters and space as 3,670.
Example
Recommended: The server handles 90k transactions per hour.