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 3161bb22e61c0..51a307102397d 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 24531e39eb42a..5dddccfa760ca 100644
--- a/packages/block-library/src/button/index.js
+++ b/packages/block-library/src/button/index.js
@@ -64,7 +64,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/embed/index.js b/packages/block-library/src/embed/index.js
index 4331e331c555d..7bf859a002373 100644
--- a/packages/block-library/src/embed/index.js
+++ b/packages/block-library/src/embed/index.js
@@ -15,7 +15,7 @@ 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,
diff --git a/packages/block-library/src/file/index.js b/packages/block-library/src/file/index.js
index 51252abf20580..7f26a4abc025e 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 1b24c82461ab6..e347c806d2af3 100644
--- a/packages/block-library/src/gallery/index.js
+++ b/packages/block-library/src/gallery/index.js
@@ -69,7 +69,7 @@ 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' ) ],
diff --git a/packages/block-library/src/heading/index.js b/packages/block-library/src/heading/index.js
index 4772818bd238d..66629352a0601 100644
--- a/packages/block-library/src/heading/index.js
+++ b/packages/block-library/src/heading/index.js
@@ -64,7 +64,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.' ),
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 00ea17c772cfe..2ac61e97c37bb 100644
--- a/packages/block-library/src/image/index.js
+++ b/packages/block-library/src/image/index.js
@@ -103,7 +103,7 @@ const schema = {
export const settings = {
title: __( 'Image' ),
- description: __( 'They’re worth 1,000 words! Insert a single image.' ),
+ description: __( 'Insert an image for visual color.' ),
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 21b40b4201392..981e0743bf249 100644
--- a/packages/block-library/src/list/index.js
+++ b/packages/block-library/src/list/index.js
@@ -60,7 +60,7 @@ 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' ) ],
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 6465c43e48391..e315f551cc9f3 100644
--- a/packages/block-library/src/paragraph/index.js
+++ b/packages/block-library/src/paragraph/index.js
@@ -77,7 +77,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/preformatted/index.js b/packages/block-library/src/preformatted/index.js
index 6170275f629d9..c3ab136e488a4 100644
--- a/packages/block-library/src/preformatted/index.js
+++ b/packages/block-library/src/preformatted/index.js
@@ -11,7 +11,7 @@ export const name = 'core/preformatted';
export const settings = {
title: __( 'Preformatted' ),
- description: __( 'Add text that respects your spacing and tabs, and also allows styling.' ),
+ description: __( 'Add custom HTML code and preview it as you edit.' ),
icon: ,
diff --git a/packages/block-library/src/pullquote/index.js b/packages/block-library/src/pullquote/index.js
index 3693fc2db2190..1dc6126394678 100644
--- a/packages/block-library/src/pullquote/index.js
+++ b/packages/block-library/src/pullquote/index.js
@@ -57,7 +57,7 @@ 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 c04cd2bcef5b2..717a62d480b53 100644
--- a/packages/block-library/src/quote/index.js
+++ b/packages/block-library/src/quote/index.js
@@ -40,7 +40,7 @@ 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.' ),
icon: ,
category: 'common',
keywords: [ __( 'blockquote' ) ],
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/verse/index.js b/packages/block-library/src/verse/index.js
index c5072386553c8..149ddd7877ed9 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 haiku. Use special spacing formats. Or quote song lyrics. (See what we did here?)' ),
icon: ,
diff --git a/packages/block-library/src/video/index.js b/packages/block-library/src/video/index.js
index 8947158c46781..ac20d15dcaa33 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: ,