Title: Version 4.7
Author: Jb Audras
Published: January 16, 2019

---

# Version 4.7

## In this article

 * [Highlights](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#highlights)
    - [REST API Content Endpoints](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#rest-api-content-endpoints)
 * [The Finer Points](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#the-finer-points)
    - [For Developers](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#for-developers)
 * [What’s New](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#whats-new)
    - [General](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#general)
    - [Posts](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#posts)
    - [Media](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#media)
    - [Appearance](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#appearance)
 * [Under The Hood](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#under-the-hood)
    - [General](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#general-2)
    - [Embeds](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#embeds)
    - [Multisite](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#multisite)
    - [Actions & Filters](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#actions-filters)

[ Back to top](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#wp--skip-link--target)

On December 6, 2016, WordPress **Version 4.7**, named for jazz vocalist Sarah “Sassy”
Vaughan, was released to the public. For more information on this enhancement and
bug-fix release, read the [WordPress Blog](https://wordpress.org/news/2016/12/vaughan/),
and see the [Changelog for 4.7](https://codex.wordpress.org/Changelog/4.7).

For **Version 4.7**, the database version (**db_version** in **wp_options**) changed
to 38590, and the [Trac](https://core.trac.wordpress.org/) revision was 39524.

 * [View Closed Tickets](https://trac.wordpress.org/query?status=closed&milestone=4.7)

## 󠀁[Highlights](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#highlights)󠁿

New Default Theme – Twenty SeventeenIt is an ambitious theme designed for business
websites that focuses on a creative home page and an easy site setup experience 
for users ([read more 1](https://make.wordpress.org/core/2016/10/18/twenty-seventeen-merge-proposal-for-4-7/)
and [2](https://make.wordpress.org/core/2016/11/29/theming-with-twenty-seventeen/)).

![](https://wp-helphub.com/wp-content/uploads/2018/07/twenty-seventeen-top.png)

 * multiple sections on the front page, selected in the Customizer.
 * a striking asymmetrical grid.
 * custom color schemes, built on top of a monochromatic foundation, and adjustable
   via a hue picker.
 * different headline placement for pages, changeable in the Customizer, via them
   options.
 * a great experience in many languages, thanks to language-specific font stacks.
 * SVG icons (a first for a default theme).
 * support for custom logo, custom header image and many post formats.
 * the use of [new functions in Core](https://make.wordpress.org/core/2016/09/09/new-functions-hooks-and-behaviour-for-theme-developers-in-wordpress-4-7)
   for making child theming easier.

**Note**: Twenty Seventeen only works on 4.7 and above. It uses the new video header
and starter content features, each launched in 4.7.

### 󠀁[REST API Content Endpoints](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#rest-api-content-endpoints)󠁿

API endpoints for WordPress content. WordPress 4.7 comes with REST API endpoints
for posts, comments, terms, users, meta, and settings. Content endpoints provide
machine-readable external access to your WordPress site with a clear, standards-
driven interface, paving the way for new and innovative methods of interacting with
your site. [Check out the REST API reference](https://developer.wordpress.org/rest-api/reference/).

## 󠀁[The Finer Points](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#the-finer-points)󠁿

  Theme Starter Content Starter Content is the theme-specific selections of content
to help showcase a theme to users and serve as a starting point for further setup
of new sites. The initial view of a theme with starter content will only happen 
for “fresh sites” – new installs that have not yet had any posts, pages, widgets,
or customizer settings updated ([read more](https://make.wordpress.org/core/2016/11/30/starter-content-for-themes-in-4-7/)).
Edit Shortcuts Visible icons appear to show you which parts can be customized right
there while live previewing. Click on a shortcut and get straight to editing, no
decoding of widget area names or extra clicks needed. Paired with starter content,
getting started with customizing your site is faster than ever ([read more](https://make.wordpress.org/core/2016/11/10/visible-edit-shortcuts-in-the-customizer-preview/)).
Video Headers WordPress 4.7 extends the Custom Header feature to introduce support
for video. Video headers play automatically, loop by default, and don’t have sound.
They work best when paired with an image, so they can progressively enhance the 
experience when video is supported ([read more](https://make.wordpress.org/core/2016/11/26/video-headers-in-4-7/)).
Smoother Nav Menu Building Many primary navigation menus for sites contain links
to the pages of your site. But what happens when you don’t have any pages yet? Now
you can add new pages while building nav menus instead of leaving the customizer
and abandoning your changes. Once you’ve published your customizations, you’ll have
new pages ready for you to fill with content ([read more](https://make.wordpress.org/core/2016/06/16/feature-proposal-content-authorship-in-menus-with-live-preview/)).
Custom CSS Sometimes you just need a few more visual tweaks to make your site perfect,
or a plugin adds something that doesn’t quite look right with your site. WordPress
4.7 allows you to instantly see changes while adding custom CSS to give your site
that polish ([read more 1](https://make.wordpress.org/core/2016/10/11/feature-proposal-better-theme-customizations-via-custom-css-with-live-previews/)
and [2](https://make.wordpress.org/core/2016/11/26/extending-the-custom-css-editor/)).
User Admin Languages and Locale Switching Users can select their preferred locale(
language) when editing their profile. The back end will be displayed in the user’s
individual locale while the locale used on the front end equals the one set for 
the whole site ([read more](https://make.wordpress.org/core/2016/11/07/user-admin-languages-and-locale-switching-in-4-7/)).
PDF Thumbnail Previews Managing your document collection is easier with WordPress
Version 4.7, which now shows preview thumbnails instead of a generic icon for PDFs
in the media library ([read more](https://make.wordpress.org/core/2016/11/15/enhanced-pdf-support-4-7/)).

### 󠀁[For Developers](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#for-developers)󠁿

  Custom Bulk Actions Simpler way to register bulk actions on list table screens(
[read more](https://make.wordpress.org/core/2016/10/04/custom-bulk-actions/)).   
Page Templates for Post Types Add support for post type templates. By opening up
the page template functionality to all post types, theme developers have even more
flexibility with the WordPress template hierarchy ([read more](https://make.wordpress.org/core/2016/11/03/post-type-templates-in-4-7/)).
WP_Taxonomy New WP_Taxonomy class provides methods to handle taxonomies. This changes
the global $wp_taxonomies to an array of WP_Taxonomy objects ([read more](https://make.wordpress.org/core/2016/10/29/wp_taxonomy-in-4-7/)).
More Theme API Goodies WordPress 4.7 includes new functions, hooks, and behavior
for theme developers ([read more](https://make.wordpress.org/core/2016/09/09/new-functions-hooks-and-behaviour-for-theme-developers-in-wordpress-4-7/))
WP_Hook The code that lies beneath actions and filters has been overhauled. You 
likely aren’t affected, but if you’ve done things to the $wp_filter global or experienced
funky recursion bugs in the past, please take a moment to read the dev note and 
test your code ([read more](https://make.wordpress.org/core/2016/09/08/wp_hook-next-generation-actions-and-filters/))
Customize Changesets Browse your site and switch themes more seamlessly within the
customizer, as your changes automatically persist in the background. Changesets 
also make exciting new features like starter content possible ([read more](https://make.wordpress.org/core/2016/10/12/customize-changesets-formerly-transactions-merge-proposal/)).
Attributes for Resource Hints you’re now able to pass specific HTML attributes to
these resource hints to make even better use of them ([read more](https://make.wordpress.org/core/2016/11/03/attributes-for-resource-hints-in-4-7/)).
wp_list_sort() and WP_List_Util WordPress 4.7 brings a few enhancements to handling
object or array lists. A new function wp_list_sort() makes it easy to sort object
or array lists by one or more of its elements’ properties. A new WP_List_Util class
was introduced as a central access point for handling lists ([read more](https://make.wordpress.org/core/2016/11/02/wp_list_sort-and-wp_list_util-in-4-7/)).

## 󠀁[What’s New](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#whats-new)󠁿

### 󠀁[General](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#general)󠁿

  Editor Changes Some of the toolbar buttons have been rearranged to make them easier
to access and to encourage proper use of the HTML elements they insert ([read more](https://make.wordpress.org/core/2016/10/28/editor-changes-in-4-7/)).

 * The headings drop down is moved to the top row.
 * The strike-through and horizontal rule button are moved down.
 * The underline and justify buttons have been removed from the bottom row.

![](https://wp-helphub.com/wp-content/uploads/2018/07/600px-v47_editor-toolbars.
png)

 * Labels for keyboard shortcuts have been added to the tooltips for buttons and
   inside drop downs to make them easier to discover.

![](https://wp-helphub.com/wp-content/uploads/2018/07/600px-v47_editor-shortcuts-
1.png)

### 󠀁[Posts](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#posts)󠁿

 * The Tag-Cloud with the popular terms have been removed from the dashboard taxonomy
   pages

### 󠀁[Media](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#media)󠁿

 * Improving accessibility of image alternative text – No more default fallback.
   To ensure your images having meaningful alternative text, you should make sure
   to set a value for alt text in your media library ([read more](https://make.wordpress.org/core/2016/11/11/improving-accessibility-of-image-alternative-text-in-4-7/)).

 * Make media library searchable by filename. ([#22744](https://core.trac.wordpress.org/ticket/22744))

### 󠀁[Appearance](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#appearance)󠁿

  Customizer Improvements WordPress 4.7 has been the most active release on record
for the customize component ([read more](https://make.wordpress.org/core/2016/11/30/customizer-improvements-in-4-7/)).

 * Create pages within live preview during site setup – Add new pages while building
   menus and setting a static front page; outline your site directly in the customizer(
   [read more](https://make.wordpress.org/core/2016/06/16/feature-proposal-content-authorship-in-menus-with-live-preview/)).
 * Improvements to the Sliding Panels UI – Customizer navigation is now faster, 
   smoother, and more accessible ([read more 1](https://make.wordpress.org/core/2016/09/28/changes-to-customizer-sliding-panelssections-in-wordpress-4-7/)
   and [2](https://make.wordpress.org/core/2016/10/12/customize-changesets-technical-design-decisions/)).
 * Customize Changesets – Browse your site and switch themes more seamlessly within
   the customizer, as your changes automatically persist in the background ([read more](https://make.wordpress.org/core/2016/10/12/customize-changesets-formerly-transactions-merge-proposal/)).
 * Custom CSS – Fine-tune your site and take your theme customizations to the next
   level with custom css in the customizer ([read more 1](https://make.wordpress.org/core/2016/10/11/feature-proposal-better-theme-customizations-via-custom-css-with-live-previews/)
   and [2](https://make.wordpress.org/core/2016/11/26/extending-the-custom-css-editor/)).

## 󠀁[Under The Hood](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#under-the-hood)󠁿

### 󠀁[General](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#general-2)󠁿

 * Allow for .nav-tab-wrapper class to be used on elements other than h3 to increase
   flexibility for custom settings pages

 * Use get_bloginfo( 'version' ) instead of global $wp_version

### 󠀁[Embeds](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#embeds)󠁿

 * Add oEmbed support for Facebook posts/activities/photo/videos/media/questions/
   notes.
 * Add oEmbed support for Twitter profile, list, and likes.
 * Using HTTPS endpoints for oEmbeds for those providers that have full HTTPS support
   and don’t redirect back to HTTP when clicking through from the embed.

### 󠀁[Multisite](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#multisite)󠁿

 * get_blog_details() replaced with get_site() ([#37102](https://core.trac.wordpress.org/ticket/37102))
 * blog_details filter deprecated ([#38491](https://core.trac.wordpress.org/ticket/38491))
 * _network_option actions and filters get $network_id ([#38319](https://core.trac.wordpress.org/ticket/38319),
   [#38320](https://core.trac.wordpress.org/ticket/38320), [#38321](https://core.trac.wordpress.org/ticket/38321)
   and [#38322](https://core.trac.wordpress.org/ticket/38322))
 * wp_get_network() deprecated ([#3753](https://core.trac.wordpress.org/ticket/37533))

### 󠀁[Actions & Filters](https://wordpress.org/documentation/wordpress-version/version-4-7/?output_format=md#actions-filters)󠁿

 * New naming-convention for Dynamic-Hooks ([#37748](https://core.trac.wordpress.org/ticket/37748)).
   Read the [updated coding standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/php/#interpolation-for-naming-dynamic-hooks).

First published

January 16, 2019

Last updated