Adding Meta Descriptions for Topics
Outputs Supported
Description meta tags contain brief summaries of web pages and are recognized by all major search engines. These tags might not factor into the search rankings by all search engines, but they are still useful for search engine optimization in web-based outputs, because they can help with the click-through rate in HTML5 output. We recommend that you create a meta tag set file, which adds an empty description meta tag by default. This is faster than adding it separately to each topic. This meta tag then becomes available at lower file levels (including topics), and you can then provide the value in the topic properties.
How to Add a Description Meta Tag Value for a Topic
- (Recommended) In the Project Organizer, expand the Advanced folder and add a new meta tag set.
- In the Content Explorer, right-click the topic file and select Properties.
- Select the Meta Tags tab.
-
If you are using a meta tag set (recommended), expand it.
If you are not using a meta tag set, click
to add a new text meta tag, which is added under the Custom section. Then, enter description as the name.
-
In the Value field, enter a description for the topic.
Tip When adding a value for a description meta tag, it is a good idea to ensure the following:
-
It should not be too long (fewer than 155 characters if possible) or too short.
-
It should accurately reflect the contents of the page.
-
It should contain relevant keywords, although you should never "stack" keywords by simply repeating them.
-
It should be unique (i.e., not the same description as you have in lots of other topics).
-
- Click OK.
This description is stored as metadata in the <head> tag of the topic file. The markup looks like this:
<meta name="description" content="This topic provides a general introduction to MadCap Flare, its benefits, and basic steps for getting started." />Note If you do not provide a meta description, Flare will use the abstract character limit to create an abstract from the text in your topic.
