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:

Onboarding to Documentation Team: An overview of what we do and how to collaborate
Documentation Issue Tracker on GitHub: Submit any Documentation Team-related issues on GitHubGitHub GitHub 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.

The documentation team holds weekly office hours and monthly Contributor Days on each Tuesday of the month in the #docs SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. channel. It’s also where you can contact the team at any time outside meetings.

Style Guide

Home / Style Guide / Word list and usage dictionary / J

J Edit

Java

Capitalize.

Don’t use a filename extension to refer to a type of file. For example, use Java file rather than .java file.

For more information, see Referring to file types.

Top ↑

JavaScript

One word. Not Java Script or Java-Script. Capitalize J and S in JavaScriptJavaScript JavaScript or JS is an object-oriented computer programming language commonly used to create interactive effects within web browsers. WordPress makes extensive use of JS for a better user experience. While PHP is executed on the server, JS executes within a user’s browser. https://www.javascript.com/..

Don’t use a filename extension to refer to a type of file. For example, use JavaScript file rather than .js file.

For more information, see Referring to file types.

Top ↑

JPEG

Acronym for Joint Photographic Experts Group. Use uppercase.

Don’t use a filename extension to refer to a type of file. For example, use JPEG file or JPG file rather than .jpeg file or jpg file.

For more information, see Referring to file types.

Top ↑

JSON

Acronym for JavaScript Object Notation. Use uppercase.

Don’t use a filename extension to refer to a type of file. For example, use JSONJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. file rather than .json file.

For more information, see Referring to file types.

Top ↑

jump

Don’t use as a noun to refer to cross-references to other pages or to links.

Don’t use as a verb to refer to going from one link to another. Use go to instead.

For more information, see Interaction verbs.

Top ↑

just

Avoid using. In most cases, just is a filler word that can be omitted without changing the meaning of a sentence.

Examples

Not recommended: The wp_mail() function just sends an email.

Recommended: The wp_mail() function sends an email.

If your meaning is unclear without just, then use a more specific term such as only, instead, or previously, or rephrase or rewrite your language to be more specific.

Examples

Not recommended: Drag the blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. just as you would drag to upload an image.

Recommended: Drag the blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. in the same way that you would drag to upload an image.

Not recommended: Just the Network Admin has the ability to install themes, plugins, and edit user profiles in a WordPress multisiteMultisite Multisite is a WordPress feature which allows users to create a network of sites on a single WordPress installation. Available since WordPress version 3.0, Multisite is a continuation of WPMU or WordPress Multiuser project. WordPress MultiUser project was discontinued and its features were included into WordPress core.https://codex.wordpress.org/Create_A_Network. network.

Recommended: Only the Network Admin has the ability to install themes, plugins, and edit user profiles in a WordPress multisiteMultisite Multisite is a WordPress feature which allows users to create a network of sites on a single WordPress installation. Available since WordPress version 3.0, Multisite is a continuation of WPMU or WordPress Multiuser project. WordPress MultiUser project was discontinued and its features were included into WordPress core.https://codex.wordpress.org/Create_A_Network. network.

Recommended: The Network Admin has the ability to install themes, plugins, and edit user profiles in a WordPress multisiteMultisite Multisite is a WordPress feature which allows users to create a network of sites on a single WordPress installation. Available since WordPress version 3.0, Multisite is a continuation of WPMU or WordPress Multiuser project. WordPress MultiUser project was discontinued and its features were included into WordPress core.https://codex.wordpress.org/Create_A_Network. network.

It is acceptable to use just to describe an approach that is easier or simpler than another.

Example

Recommended: To add a new blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience., click on the Inserter button, or just use the slash command.

Top ↑

justify, justified

Don’t use to refer to the alignment of text to the left or right margin. Instead, use alignment. Justified text is text that is aligned on both the right and the left margins. To describe alignment on one margin only, use left-aligned or right-aligned, not left-justified or right-justified.

Last updated: August 17, 2021