Cloudflare Docs
Style Guide
Style Guide
Edit this page on GitHub
Set theme to dark (⇧+D)

Product descriptions

​​ Definition

Statements about the product and its benefits for customers.

​​ Used in

Overview (or Landing Page), Support home page, Cloudflare Docs home page

​​ Structure

There are two product descriptions: short and long. Both descriptions are used in the Overview (or Landing page) as part of an introduction to the product.

​​ Short description

The short description should be a short summary statement about the product. This does not need to be, and ideally should not be, a complete sentence.

Example

Cloudflare Registrar: Cloudflare’s domain registrar

​​ Long description

A long product description should summarize the product and the value or benefits it brings customers. It is comprised of two main assertions: 1) what the product does, and 2) how this benefits the customer. This description is used in the Overview (or Landing page) as an introduction to the product.

Intent: To show what a customer could use this product for. It should not be trying to sell like marketing content, but you can refer to marketing statements as they give good summaries and descriptions. Often times, you can use a the same or similar and change the tone to be more product appropriate.

Length: 2-4 sentences (keep sentences readable - 7th grade reading level rule)

Example

Cloudflare Registrar: Manage your domain with Cloudflare Registrar and add an additional layer of security to your DNS records for free.