Additional labels for custom post types and custom taxonomies

Welcome!

The WordPress coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. development team builds WordPress! Follow this site for general updates, status reports, and the occasional code debate. There’s lots of ways to contribute:

Found a bugbug A bug is an error or unexpected result. Performance improvements, code optimization, and are considered enhancements, not defects. After feature freeze, only bugs are dealt with, with regressions (adverse changes from the previous version) being the highest priority.? Create a ticket in the bug tracker.

Want to contribute? Get started quickly with tickets marked as good first bugs for new contributors or join a bug scrub. There’s more on the reports page, like patches needing testing, and on feature projects page.

Other questions? Here is a detailed handbook for contributors, complete with tutorials.

In WordPress 4.3 and 4.4, additional labels have been made available for custom post types and custom taxonomies. These get passed in via the labels argument when using register_post_type() and register_taxonomy().

New post type labels in 4.3:

featured_image – Overrides the “Featured ImageFeatured image A featured image is the main image used on your blog archive page and is pulled when the post or page is shared on social media. The image can be used to display in widget areas on your site or in a summary list of posts.” phrase for this post type. See #19257.
set_featured_image – Overrides the “Set featured image” phrase for this post type. See #19257.
remove_featured_image – Overrides the “Remove featured image” phrase for this post type. See #19257.
use_featured_image – Overrides the “Use as featured image” phrase for this post type. See #19257.

New post type labels in 4.4:

archives – The post type archive label used in nav menus. Default “Post Archives”. See #16075.
insert_into_item – Overrides the “Insert into post”/”Insert into page” phrase (used when inserting media into a post). See #33616.
uploaded_to_this_item – Overrides the “Uploaded to this post”/”Uploaded to this page” phrase (used when viewing media attached to a post). See #33616.
filter_items_list – Screen reader text for the filterFilter Filters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. links heading on the post type listing screen. Default “Filter posts list”/”Filter pages list”. See #32147.
items_list_navigation – Screen reader text for the pagination heading on the post type listing screen. Default “Posts list navigation”/”Pages list navigation”. See #32147.
items_list – Screen reader text for the items list heading on the post type listing screen. Default “Posts list”/”Pages list”. See #32147.

New taxonomyTaxonomy A taxonomy is a way to group things together. In WordPress, some common taxonomies are category, link, tag, or post format. https://codex.wordpress.org/Taxonomies#Default_Taxonomies. labels in 4.3:

no_terms – Used when indicating that there are no terms in the given taxonomy associated with an object. Default “No tags”/”No categories”. See #32150.

New taxonomy labels in 4.4:

items_list_navigation – Screen reader text for the pagination heading on the term listing screen. Default “Tags list navigation”/”Categories list navigation”. See #32147.
items_list – Screen reader text for the items list heading on the term listing screen. Default “Tags list”/”Categories list”. See #32147.

See the documentation for get_post_type_labels() and get_taxonomy_labels() for the full list of available labels.

Scott Kingsley Clark 5:16 pm on December 11, 2015

Thanks for this! Super useful, I didn’t realize any had been added in 4.3, so thanks for including those too!
Tracy (LilJimmi) Levesque 5:33 pm on December 11, 2015

This is great. Thank you!
Rami Yushuvaev 2:20 am on December 12, 2015

You can use the “Post Type Generator” (https://generatewp.com/post-type/) and the “TaxonomyTaxonomy A taxonomy is a way to group things together. In WordPress, some common taxonomies are category, link, tag, or post format. https://codex.wordpress.org/Taxonomies#Default_Taxonomies. Generator” (https://generatewp.com/taxonomy/) to create custom code with those new labels.
Ihor Vorotnov 3:32 pm on December 12, 2015

Working with CPT/CT on a regular basis, haven’t noticed that. Kind of a “silent upgrade” 🙂 Super useful though!
Igor Jerosimic 10:17 pm on December 20, 2015

Label ‘insert_into_item’ doesn’t work if featured imageFeatured image A featured image is the main image used on your blog archive page and is pulled when the post or page is shared on social media. The image can be used to display in widget areas on your site or in a summary list of posts. is not enabled?
- John Blackbourn 10:37 pm on December 20, 2015
  
  The `insert_into_item` label is unrelated to featured images. I’ve just tested this and it works as expected even if featured images aren’t enabled.