HTML Meta Tags for Individual Topics

Abstract

Learn how to add a custom meta name and content pair to an individual topic.

You can add HTML name and content metadata pairs to any topic. HTML name and content pairs are often used by other applications that need to access your published content, for example, Google Analytics.

To add HTML metadata to an individual topic, use Paligo's taxonomy feature. You will need to create a "parent" taxonomy tag for the name value and then one or more "child" taxonomy tags for the content value. When you publish to HTML5, Paligo will add the HTML metadata to the topic when it processes the output. The HTML metadata will appear as:

<meta name="name of metadata" content="value of metadata" />

Note

Paligo only supports metadata name and content pairs. It does not support other metadata attributes such as property.

Note

This article explains how to add a custom metadata name and pair to one specific topic. To create an HTML meta description for a topic, see HTML Meta Description for Topics, and if you want to add a meta name and content pair to all topics at once, see Metadata for All Topics in a Publication.

To add a custom HTML metadata name and content pair to a topic:

  1. In the Content Manager, expand the Taxonomy Manager section.

  2. Select the options menu ( ... ) for Taxonomies and then select Create Taxonomy Tag.

  3. Give the taxonomy tag a name. The name will be used as the value for the name part of the metadata. For example, if you enter "Monitor" as the name, the HTML metadata will use it like this:

    <meta name="Monitor" content = <not defined yet!> />

    The taxonomy tag you have created in this step is the "parent" taxonomy tag.

    Taxonomy manager section showing the Taxonomies tag has a child tag called "Monitor"

  4. Select the options menu ( ... ) for the "parent" taxonomy tag and then select Create Taxonomy Tag. Paligo creates a new tag, and it is a "child" of the "parent" tag you created in the previous step. This hierarchy is important, as "child" tags are used for the content values in the metadata.

  5. Give the child taxonomy tag a name. The name will be used as a value for the content part of the metadata. For example, if you enter "Temperature" as the name, Paligo will add this to the HTML metadata:

    <meta name="Monitor" content="Temperature" />

    Taxonomy manager section showing the Taxonomies tag has a child tag called "Monitor". The "Monitor" tag has its own child tag called "Temperature".

    Note

    You need one tag for each value, so if you want the content metadata to have multiple values, create one "child" tag for each value.

  6. Repeat steps 4 and 5 to create any additional values for the content part of the metadata. For example, you could create a "child" tag for "Humidity" and then Paligo will add this HTML metadata:

    <meta name="Monitor" content="Temperature, Humidity" />

  7. Select the options menu ( ... ) for the Taxonomies tag and then select Floating Content Panel. Paligo opens the taxonomy tag hierarchy in a "floating" dialog.

    Content Manager is on the left, showing a list of topics in a publication. The Taxonomies floating panel is shown on the right and contains the taxonomy hierarchy.

  8. Drag and drop the "parent" and "child" tags for your name/content pair onto the topics that you want to use them.

    Dotted arrows show that you can drag tags from the Taxonomies panel on to the topics in the Content Manager.

    Tip

    To check that the tags have been applied, select the folder that contains the topic to display Resource View. There, you can see what taxonomy tags are applied to the topics in that folder.

    Resource View shows which taxonomies have been applied to a topic.

  9. Publish the content using an HTML5 layout that has the following settings in place:

    These are in the Classes and attributes settings:

    • Output taxonomies set to Enable

    • Value structure for taxonomy class names set to Descendants

    • Underscore delimiter in taxonomy class names set to Enable

    • Create HTML meta tags from taxonomies set to Enable.

    Note

    To use the HTML meta tag for Google Analytics, you will also need to set up the property id. You can find it in the layout's settings at: Analytics and other integrations > Google analytics property id (tracking id) or container id.

  10. Check that the meta name and content pair(s) are included in your output. Unzip the output file and open index.html in a browser. Navigate to a page that should have the meta tag and then use the browser's inspect feature to view the source code. You should see that the meta tag is included inside the <head> element.

    If the meta name and content is not included, check that you have all of the required layout settings in place and that you correctly applied the taxonomy tag to your topic.

In this section:
See also: