Spelling

Topics

Alert: This document is a working draft. If you find an error or have any suggestions, please comment below.

Terminology Terminology

The following conventions of spelling and terminology apply to the manuals, web pages, comments, and (except where they require spaces or hyphens to be used) function and variable names, although consistency in user-visible documentation and diagnostics is more important than that in comments and code. Also don’t forget that the Code Reference is auto-generated from the code. The following table lists some simple cases:

Use… …instead of Notes
American spelling (in particular -ize, -or) British spelling (in particular -ise, -our)  
“a user” or “a URL” “an user” or “an URL” #31894, #36218
“Ajax” “ajax” or “AJAX” “The name [Ajax] is shorthand for Asynchronous JavaScript + XML, and it represents a fundamental shift in what’s possible on the Web.” (Source)
“back end” (noun) “back-end” or “backend” #34887
“back-end” (adjective) “back end” or “backend” #34887
“backward compatibility” or “back-compat” “backwards compatibility” or “backwards compat” #36835
“block editor” or “block-based editor” “Block Editor” or “Gutenberg” When referring to the new editor.
“Classic Editor” “classic editor” When referring to the Classic Editor plugin.
“classic editor” “Classic Editor” When referring to the classic editor interface and not the plugin.
“Paragraph block” “Paragraph Block” or “paragraph block” When referring to blocks capitalize the block name and keep ‘block’ lowercase. github#16118
“Customizer” “Theme Customizer” or “customizer” The Customizer isn’t necessarily theme-specific, #29947
“email” “e-mail” #26156
“front end” (noun) “front-end” or “frontend” #34887
“front-end” (adjective) “front end” or “frontend” #34887
“homepage” (noun) “home page” #41828
“installation” (noun) “install” The word “install” is not a noun. When referring to an instance of WordPress, the correct word to use is “installation”.
#41620
“JavaScript” “Javascript” or “javascript” #30569
“log in” (verb) “login” The word “login” is not a verb. When referring to the action of logging in, the correct phrase to use is “log in”.
#18294
“meta box” “metabox”  
“oEmbed” “embed”  
“retrieve” “retreive” or “retrive” “retreive” or “retrive” aren’t words, [2465]
“term meta” “termmeta”  

Inspired by the GCC Coding Convention.

Top ↑

Capitalization Capitalization

  • Labels
  • Button labels
  • Actions

Top ↑

Abbreviations and Acronyms Abbreviations and Acronyms

Use abbreviations and acronyms only when they are familiar.

Top ↑

Quotation marks Quotation marks

In DocBlock comments use the straight sin­gle quote (') or the straight dou­ble quote ("). In strings, which are visible to users, use curly quotes: The open­ing sin­gle quote (‘), the clos­ing sin­gle quote (’), the open­ing dou­ble quote (“), and the clos­ing dou­ble quote (”).
See also Butterick’s Practical Typography.