Title and description for SEO

When you create a new article, the following two metadata items are required:

• title
• description

Title and description metadata are what Google and other search engines use to display content on the search engine results page (SERP). The title metadata is not displayed on the article page; instead, the first heading (# <Title>) is used.

Examples:

---
title: How to Use decryptPassword in Adobe Analytics
description: Decrypt a password stored in an external account with the decryptPassword function. Learn how to call in JSSP or SOAP call implementations with Adobe API.
---

Continue reading for important guidelines on title and description.

title

This metadata is required for articles. In each article, specify a title in both metadata (title:) and as a heading (# <Head1>), or page title. The title metadata is used for search results, the breadcrumb, and browser tabs. The page title heading is used for page display. These titles should correspond to one another (when not identical) because readers can see the breadcrumb and the page title at the same time.

Examples of how you might use a title and description metadata, along with an article title:

---
title: What is Cohort Analysis and How Does it Work?
description: Dig deeper into the data around your audience and break into related groups with Cohort Analysis in Adobe Analytics.
---

# Overview of Cohort Analysis in Adobe Analytics

Important editorial guidelines for title metadata

• Capitalization: Use title case for title, and sentence case for article (page) title.

• 60 characters is the maximum length for title (English). 120 characters maximum for localization, including spaces and the pipe/product name (see the important note above). A useful tool for counting characters is the Google SERP snippet optimization tool.

• The system appends | Adobe nameofproduct when creating title metadata for output. (See the important note above). Because of this, do not include the product name in your meta title unless it’s necessary to understand the meaning of the title.

• The title metadata will rarely match the article title heading (# Title) word-for-word. Meaning, optimize the meta title for SEO. Optimize the article title for reading when in the context of the help guide. For example:

  • Metadata title: What Is a Fallout Report?
  • Article title: Overview of Fallout reports in Workspace

• Overview, by itself, isn’t useful as a metadata or article title…

• Use keywords. Your most important keywords should be closer to the beginning of the title (for both the meta title and article title). The primary keywords are the feature name or article’s subject, and words people type when searching. For example:

  • How to, as in How to Upload a PDF
  • Learn How to, as in Learn How to Use Adobe Target
  • Get Started with, as in Get Started with Activities in Target
  • Feature explained, as in Page Views Metrics Explained
  • Action feature, as in Download Data with CSV
  • Guide to, as in Guide to Statistical Anomaly

description

Required for articles. Description is used by search engines and displays under the title metadata on a search engine results page.

Maximum length is 160 characters. Ideally, the size is around 150-160 characters, but anything over 60 is acceptable. The goal is to use as much as the description as possible to target keywords for Google to rank the page higher.

If you need to shorten or otherwise edit the description of an article that’s linked to on a landing page, use landing-page-description. Otherwise, the description value is used in landing page links to articles.

Editorial guidelines for description metadata

• Think of your description as describing the intent of the article.
• Make sure the description reads naturally; do not cram random keywords in the description - Google will flag this and could demote content.
• Write your description in two parts: First, summarize the content of the article, then add a call to action and the intent of the article. Examples:
  • description: Sign in to Adobe Analytics to start configuring and accessing reports, add users, and more. Follow these steps for a successful Adobe Analytics sign-in.
  • description: Decrypt a password stored in an external account with the decryptPassword function. Learn how to call in JSSP or SOAP call implementations with Adobe Analytics.
• Think of what users search for; for example, Learn how to use Adobe xx might be something users type rather than simply Overview of Adobe xx.

Some examples of effective descriptions:

• Action feature with call to action: description: Dig deeper into the data around your audience and break into related groups with Cohort Analysis. Learn about Cohort Analysis with Adobe Analytics.
• Learn how to, Get started with and Discover are all great ways to add calls to action or describe intent, as in description: Learn how to use Data Warehouse in Analytics to get custom reports. Transform raw data into insights that reveal patterns. Get started with Adobe Analytics.