diff --git a/packages/block-library/src/archives/index.js b/packages/block-library/src/archives/index.js
index e978f7d640341..8dfca64a8823c 100644
--- a/packages/block-library/src/archives/index.js
+++ b/packages/block-library/src/archives/index.js
@@ -14,7 +14,7 @@ export const name = 'core/archives';
export const settings = {
title: __( 'Archives' ),
- description: __( 'Display a monthly archive of your site’s Posts.' ),
+ description: __( 'Display a monthly archive of your posts.' ),
icon: ,
diff --git a/packages/block-library/src/audio/index.js b/packages/block-library/src/audio/index.js
index 6809808095902..1c2980850f0f2 100644
--- a/packages/block-library/src/audio/index.js
+++ b/packages/block-library/src/audio/index.js
@@ -17,7 +17,7 @@ export const name = 'core/audio';
export const settings = {
title: __( 'Audio' ),
- description: __( 'Embed an audio file and a simple audio player.' ),
+ description: __( 'Embed a simple audio player.' ),
icon: ,
diff --git a/packages/block-library/src/button/index.js b/packages/block-library/src/button/index.js
index eecfaeb7b7d3b..0f8f7d00b8e9d 100644
--- a/packages/block-library/src/button/index.js
+++ b/packages/block-library/src/button/index.js
@@ -63,7 +63,7 @@ const colorsMigration = ( attributes ) => {
export const settings = {
title: __( 'Button' ),
- description: __( 'Want visitors to click to subscribe, buy, or read more? Get their attention with a button.' ),
+ description: __( 'Prompt visitors to take action with a custom button.' ),
icon: ,
diff --git a/packages/block-library/src/categories/index.js b/packages/block-library/src/categories/index.js
index a51d734c33072..ab9c198eff461 100644
--- a/packages/block-library/src/categories/index.js
+++ b/packages/block-library/src/categories/index.js
@@ -14,7 +14,7 @@ export const name = 'core/categories';
export const settings = {
title: __( 'Categories' ),
- description: __( 'Display a list of all your site’s categories.' ),
+ description: __( 'Display a list of all categories.' ),
icon: ,
diff --git a/packages/block-library/src/classic/index.js b/packages/block-library/src/classic/index.js
index a8fd64e08daa0..e30d7fa75eada 100644
--- a/packages/block-library/src/classic/index.js
+++ b/packages/block-library/src/classic/index.js
@@ -15,7 +15,7 @@ export const name = 'core/freeform';
export const settings = {
title: _x( 'Classic', 'block title' ),
- description: __( 'It’s the classic WordPress editor and it’s a block! Drop the editor right in.' ),
+ description: __( 'Use the classic WordPress editor.' ),
icon: ,
diff --git a/packages/block-library/src/code/index.js b/packages/block-library/src/code/index.js
index badc677610aae..cb304079e1e2c 100644
--- a/packages/block-library/src/code/index.js
+++ b/packages/block-library/src/code/index.js
@@ -18,7 +18,7 @@ export const name = 'core/code';
export const settings = {
title: __( 'Code' ),
- description: __( 'Add text that respects your spacing and tabs -- perfect for displaying code.' ),
+ description: __( 'Display code snippets that respect your spacing and tabs.' ),
icon: ,
diff --git a/packages/block-library/src/cover/index.js b/packages/block-library/src/cover/index.js
index 4ae19ad8d1139..c844c1d7294f7 100644
--- a/packages/block-library/src/cover/index.js
+++ b/packages/block-library/src/cover/index.js
@@ -82,7 +82,7 @@ const VIDEO_BACKGROUND_TYPE = 'video';
export const settings = {
title: __( 'Cover' ),
- description: __( 'Add a full-width image or video, and layer text over it — great for headers.' ),
+ description: __( 'Add an image or video with a text overlay — great for headers.' ),
icon: ,
diff --git a/packages/block-library/src/embed/index.js b/packages/block-library/src/embed/index.js
index 4331e331c555d..1433b4020a03c 100644
--- a/packages/block-library/src/embed/index.js
+++ b/packages/block-library/src/embed/index.js
@@ -15,10 +15,14 @@ export const name = 'core/embed';
export const settings = getEmbedBlockSettings( {
title: _x( 'Embed', 'block title' ),
- description: __( 'The Embed block allows you to easily add videos, images, tweets, audio, and other content to your post or page.' ),
+
+ description: __( 'Embed videos, images, tweets, audio, and other content from external sources.' ),
+
icon: embedContentIcon,
+
// Unknown embeds should not be responsive by default.
responsive: false,
+
transforms: {
from: [
{
diff --git a/packages/block-library/src/file/index.js b/packages/block-library/src/file/index.js
index e7d07c512eb59..a64a9f41ed9c4 100644
--- a/packages/block-library/src/file/index.js
+++ b/packages/block-library/src/file/index.js
@@ -23,7 +23,7 @@ export const name = 'core/file';
export const settings = {
title: __( 'File' ),
- description: __( 'Add a link to a file that visitors can download.' ),
+ description: __( 'Add a link to a downloadable file.' ),
icon: ,
diff --git a/packages/block-library/src/gallery/index.js b/packages/block-library/src/gallery/index.js
index 137090eaf339b..4e206255732c8 100644
--- a/packages/block-library/src/gallery/index.js
+++ b/packages/block-library/src/gallery/index.js
@@ -68,11 +68,17 @@ export const name = 'core/gallery';
export const settings = {
title: __( 'Gallery' ),
- description: __( 'Display multiple images in an elegantly organized tiled layout.' ),
+
+ description: __( 'Display multiple images in a rich gallery.' ),
+
icon: ,
+
category: 'common',
+
keywords: [ __( 'images' ), __( 'photos' ) ],
+
attributes: blockAttributes,
+
supports: {
align: true,
},
diff --git a/packages/block-library/src/heading/index.js b/packages/block-library/src/heading/index.js
index 7190310f50521..2e46aa2f2c734 100644
--- a/packages/block-library/src/heading/index.js
+++ b/packages/block-library/src/heading/index.js
@@ -62,7 +62,7 @@ export const name = 'core/heading';
export const settings = {
title: __( 'Heading' ),
- description: __( 'Introduce topics and help visitors (and search engines!) understand how your content is organized.' ),
+ description: __( 'Introduce new sections and organize content to help visitors (and search engines) understand the structure of your content.' ),
icon: ,
diff --git a/packages/block-library/src/html/index.js b/packages/block-library/src/html/index.js
index 5243df8962f49..c7307aa53e9b4 100644
--- a/packages/block-library/src/html/index.js
+++ b/packages/block-library/src/html/index.js
@@ -13,7 +13,7 @@ export const name = 'core/html';
export const settings = {
title: __( 'Custom HTML' ),
- description: __( 'Add your own HTML (and view it right here as you edit!).' ),
+ description: __( 'Add custom HTML code and preview it as you edit.' ),
icon: ,
diff --git a/packages/block-library/src/image/index.js b/packages/block-library/src/image/index.js
index f7f6e17f6b66c..e8d26b8eb8841 100644
--- a/packages/block-library/src/image/index.js
+++ b/packages/block-library/src/image/index.js
@@ -102,7 +102,7 @@ const schema = {
export const settings = {
title: __( 'Image' ),
- description: __( 'They’re worth 1,000 words! Insert a single image.' ),
+ description: __( 'Insert an image to make a visual statement.' ),
icon: ,
diff --git a/packages/block-library/src/latest-comments/index.js b/packages/block-library/src/latest-comments/index.js
index 61310f4ebda14..d7420744d0011 100644
--- a/packages/block-library/src/latest-comments/index.js
+++ b/packages/block-library/src/latest-comments/index.js
@@ -14,7 +14,7 @@ export const name = 'core/latest-comments';
export const settings = {
title: __( 'Latest Comments' ),
- description: __( 'Show a list of your site’s most recent comments.' ),
+ description: __( 'Display a list of your most recent comments.' ),
icon: ,
diff --git a/packages/block-library/src/list/index.js b/packages/block-library/src/list/index.js
index 87d56d534c692..a17cd2bbc28eb 100644
--- a/packages/block-library/src/list/index.js
+++ b/packages/block-library/src/list/index.js
@@ -58,9 +58,13 @@ export const name = 'core/list';
export const settings = {
title: __( 'List' ),
- description: __( 'Numbers, bullets, up to you. Add a list of items.' ),
+
+ description: __( 'Create a bulleted or numbered list.' ),
+
icon: ,
+
category: 'common',
+
keywords: [ __( 'bullet list' ), __( 'ordered list' ), __( 'numbered list' ) ],
attributes: schema,
diff --git a/packages/block-library/src/media-text/index.js b/packages/block-library/src/media-text/index.js
index 14a3a3281f093..d82d86228091e 100644
--- a/packages/block-library/src/media-text/index.js
+++ b/packages/block-library/src/media-text/index.js
@@ -26,6 +26,8 @@ export const name = 'core/media-text';
export const settings = {
title: __( 'Media & Text' ),
+ description: __( 'Set media and words side-by-side media for a richer layout.' ),
+
icon: ,
category: 'layout',
diff --git a/packages/block-library/src/more/index.js b/packages/block-library/src/more/index.js
index a42f1025723c0..9334ed2e0941c 100644
--- a/packages/block-library/src/more/index.js
+++ b/packages/block-library/src/more/index.js
@@ -25,7 +25,7 @@ export const name = 'core/more';
export const settings = {
title: _x( 'More', 'block name' ),
- description: __( 'Want to show only part of this post on your blog’s home page? Insert a "More" block where you want the split.' ),
+ description: __( 'Want to show only an excerpt of this post on your home page? Use this block to define where you want the separation.' ),
icon: ,
diff --git a/packages/block-library/src/nextpage/index.js b/packages/block-library/src/nextpage/index.js
index f5d35e4eb3073..02114bd72c078 100644
--- a/packages/block-library/src/nextpage/index.js
+++ b/packages/block-library/src/nextpage/index.js
@@ -11,7 +11,7 @@ export const name = 'core/nextpage';
export const settings = {
title: __( 'Page break' ),
- description: __( 'This block allows you to set break points on your post. Visitors of your blog are then presented with content split into multiple pages.' ),
+ description: __( 'Separate your content into a multi-page experience.' ),
icon: ,
diff --git a/packages/block-library/src/paragraph/index.js b/packages/block-library/src/paragraph/index.js
index 25e83f1018c03..890d4fe16e525 100644
--- a/packages/block-library/src/paragraph/index.js
+++ b/packages/block-library/src/paragraph/index.js
@@ -76,7 +76,7 @@ export const name = 'core/paragraph';
export const settings = {
title: __( 'Paragraph' ),
- description: __( 'Add some basic text.' ),
+ description: __( 'Start with the building block of all narrative.' ),
icon: ,
diff --git a/packages/block-library/src/pullquote/index.js b/packages/block-library/src/pullquote/index.js
index f9c0eb41a0399..afd9526fe53a0 100644
--- a/packages/block-library/src/pullquote/index.js
+++ b/packages/block-library/src/pullquote/index.js
@@ -51,10 +51,9 @@ const blockAttributes = {
export const name = 'core/pullquote';
export const settings = {
-
title: __( 'Pullquote' ),
- description: __( 'Highlight a quote from your post or page by displaying it as a graphic element.' ),
+ description: __( 'Give special visual emphasis to a quote from your text.' ),
icon: ,
diff --git a/packages/block-library/src/quote/index.js b/packages/block-library/src/quote/index.js
index cf105e4cc1280..04633f1195bf6 100644
--- a/packages/block-library/src/quote/index.js
+++ b/packages/block-library/src/quote/index.js
@@ -36,9 +36,13 @@ export const name = 'core/quote';
export const settings = {
title: __( 'Quote' ),
- description: __( 'Maybe someone else said it better -- add some quoted text.' ),
+
+ description: __( 'Give quoted text visual emphasis. "In quoting others, we cite ourselves." — Julio Cortázar' ),
+
icon: ,
+
category: 'common',
+
keywords: [ __( 'blockquote' ) ],
attributes: blockAttributes,
diff --git a/packages/block-library/src/separator/index.js b/packages/block-library/src/separator/index.js
index a85576d97b3ad..a3a5caef52fda 100644
--- a/packages/block-library/src/separator/index.js
+++ b/packages/block-library/src/separator/index.js
@@ -10,7 +10,7 @@ export const name = 'core/separator';
export const settings = {
title: __( 'Separator' ),
- description: __( 'Insert a horizontal line where you want to create a break between ideas.' ),
+ description: __( 'Create a break between ideas or sections with a horizontal line.' ),
icon: ,
diff --git a/packages/block-library/src/shortcode/index.js b/packages/block-library/src/shortcode/index.js
index e5fd517798d6c..06464c52e7082 100644
--- a/packages/block-library/src/shortcode/index.js
+++ b/packages/block-library/src/shortcode/index.js
@@ -13,7 +13,7 @@ export const name = 'core/shortcode';
export const settings = {
title: __( 'Shortcode' ),
- description: __( 'Add a shortcode -- a WordPress-specific snippet of code written between square brackets.' ),
+ description: __( 'Insert additional custom elements with a WordPress shortcode.' ),
icon: ,
diff --git a/packages/block-library/src/spacer/index.js b/packages/block-library/src/spacer/index.js
index 6b66cf4eadd53..12f362b40f623 100644
--- a/packages/block-library/src/spacer/index.js
+++ b/packages/block-library/src/spacer/index.js
@@ -17,7 +17,7 @@ export const name = 'core/spacer';
export const settings = {
title: __( 'Spacer' ),
- description: __( 'Add an element with empty space and custom height.' ),
+ description: __( 'Add white space between blocks and customize its height.' ),
icon: ,
diff --git a/packages/block-library/src/table/index.js b/packages/block-library/src/table/index.js
index 5934b8a91332a..681753779e663 100644
--- a/packages/block-library/src/table/index.js
+++ b/packages/block-library/src/table/index.js
@@ -76,8 +76,11 @@ export const name = 'core/table';
export const settings = {
title: __( 'Table' ),
- description: __( 'Insert a table -- perfect for sharing charts and data.' ),
+
+ description: __( 'Insert a table — perfect for sharing charts and data.' ),
+
icon: ,
+
category: 'formatting',
attributes: {
diff --git a/packages/block-library/src/verse/index.js b/packages/block-library/src/verse/index.js
index 1f91c5398a8b7..e9fac9ad70702 100644
--- a/packages/block-library/src/verse/index.js
+++ b/packages/block-library/src/verse/index.js
@@ -16,7 +16,7 @@ export const name = 'core/verse';
export const settings = {
title: __( 'Verse' ),
- description: __( 'A block for haiku? Why not? Blocks for all the things! (See what we did here?)' ),
+ description: __( 'Insert poetry. Use special spacing formats. Or quote song lyrics.' ),
icon: ,
diff --git a/packages/block-library/src/video/index.js b/packages/block-library/src/video/index.js
index f0ccee2fe48ac..6de3ff7362fc4 100644
--- a/packages/block-library/src/video/index.js
+++ b/packages/block-library/src/video/index.js
@@ -17,7 +17,7 @@ export const name = 'core/video';
export const settings = {
title: __( 'Video' ),
- description: __( 'Embed a video file and a simple video player.' ),
+ description: __( 'Embed a video from your media library or upload a new one.' ),
icon: ,