The GitHub authoring and SCCM publishing platform supports a wide variety of metadata parameters. A complete list, sample usage, and more information is tabulated below.

Metadata Overview

Writers specify metadata in three locations:

  • At the beginning of each article/MD file.
  • At the beginning of the file in the user guide directory. This metadata is added to all articles in the guide, unless overwritten.
  • (Optional) In the file at the repo level. This metadata is added to all articles in the repo, unless overwritten.

Metadata hierarchy

The repo-level metadata ( can be overwritten by user-guide-level metadata (, which can be overwritten by article-level metadata. For example, you might specify a solution value (such as solution: Analytics) in the file, and then specify a different solution value for a user guide or article (such as solution: Analytics, Launch).


Be careful when applying the same metadata fields in both the file and file. For example, if you set index: no in both places and then change it to index: yes in the file, no change will take place. That’s because the file value will override the value.

In other words, don’t add the same metadata fields at lower levels unless you want to override the higher value.

Metadata purposes

Some metadata, such as product, solution, and type, requires specific enumerated values in order to function consistently and properly when used. For example, solution and type are used for search filtering, while product and sub-product are used for Omega Analytics metrics. Metadata can also be used in the future for filtering content based on audience, doc-type, or difficulty. Use appropriate metadata values to ensure consistency and accuracy.

Any metadata you specify is passed through to the HTML page.

Contact the SSE team if you need to add ENUM values to existing metadata or if you need to use custom metadata.

Metadata In Use

When you create a new article, we ask that you add the following two metadata items:

  • title
  • description


title: Experiences and offers for Adobe Target
description: An Adobe Target experience determines which content displays when the visitor meets the audience criteria for an activity.


Title is used in search results.

Example: title: Creating widgets in Adobe Target

Maximum length is 69 characters (English) / 120 characters (LOC), including spaces. As a rule, make sure that the title metadata in the article header is the same as the article title heading (# Title). Both can be used.


Description is used in search result snippets. It is also used if an article is linked to from a landing page.

Example: description: Learn how to use a feature.


Example: keywords: experience, visual experience composer, enhanced experience composer

Keywords are copied during the migration for reference. Keywords are optional. They can be used in internal and external search.


Use solution metadata to Experience League search filtering. Note that solution and product are used for different purposes that require different ENUM values—one for search filtering and one for Omega analytics. See the product section next.


  • solution: Customer Journey Analytics
  • solution: Experience Platform, Data Collection
  • solution: Campaign, Campaign Standard

solution metadata

You must use one (or more) of the following enumerated values for solution:

  • Acrobat DC
  • Admin
  • Adobe Sign
  • Advertising Cloud
  • Analytics
  • Audience Manager
  • Campaign
  • Campaign Classic
  • Campaign Standard
  • Connect
  • Core Services
  • Creative Cloud
  • Customer Journey Analytics
  • Data Collection
  • Document Cloud
  • Dynamic Media Classic
  • Experience Cloud
  • Experience Cloud Services
  • Experience Manager
  • Experience Manager Forms
  • Experience Manager Screens
  • Experience Manager Sites
  • Experience Manager Assets
  • Experience Platform
  • Experience Platform Launch
  • Intelligent Services
  • Journey Orchestration
  • Magento
  • Marketo
  • Offer Decisioning
  • Primetime
  • Real-time Customer Data Platform
  • Social
  • Target

If you specify a value that’s not on this list, validation will fail.

If you need a solution to be added to this list, please log an Experience League UGP JIRA task, or contact the SSE team.

API call that displays solution values


Example: product: target

In use. The product item requires a defined enum value so that it can be used in analytics. These product names MUST correspond with the Omega product names.

For search filtering, use the solution metadata described above.


Use the appropriate product metadata for Omega data collection.

Valid ENUM values:

  • adobe analytics or analytics or aa
  • adobe audience manager or audience manager
  • adobe campaign or campaign or ac
  • adobe experience manager or experience-manager or aem
  • adobe experience manager cloud manager or experience manager cloud manager or cm
  • adobe livefyre or livefyre or alf
  • adobe marketing cloud or marketing cloud or experience-cloud or experience cloud or amc
  • adobe media optimizer or media optimizer or or amo
  • adobe target or target or at
  • adobe dynamic tag management or dynamic tag management or dtm
  • adobe experience platform or experience platform
  • adobe launch or launch
  • adobe primetime or primetime
  • adobe social or social
  • auditor
  • adobe core services or core services

Product not on the list? Please contact the SSE team.


Example: sub-product: search

We can use this for Adobe Analytics (Omega) data, among other applications. Work with solution teams to determine enum values for sub-products in your solution.

Example: livefyre could include library, search, instagram-search, apps, media-wall, carousel. AEM could include assets, sites, community and so on.


Example: type: Tutorial

In use for EXL search and filtering APIs. Use only a defined enum value.

type metadata

The default value is Documentation.

Valid ENUM values:

  • Documentation (default)
  • Tutorial
  • Course
  • Event


Example: index: y

Default is no. Using ‘n’ or ‘no’ excludes the page from external search (if available) and sitemap. Important for pages such as “Contact us,” soft-launches, deprecated articles, or later articles in a tutorial series. You can also use hide.


hide: yes

Default is no. Using ‘y’ or ‘yes’ excludes the page from both external and internal search. (When hide = yes,index is set to no automatically in the output file.) The article will appear in the TOC unless you set hidefromtoc to yes.

If you add hide: yes to the file, the entire guide will be excluded from external and internal search and available only through a URL.

See Hiding files.


hidefromtoc: yes

If you set hidefromtoc to yes, the article does not appear in the TOC and is available only through direct links or URLs.

If all articles in a TOC section are hidden from the TOC, the section is hidden in the left nav.

See Hiding files.


Example: snippet: n

Opt out of Google feature snippets. Default is yes.


Example: mini-toc-levels: 2

Default is 2. Valid values include 1, 2, and 3.

This determines the number of heading levels that appear in the mini-TOC in the right nav. This metadata is usually added to the or file, but it’s sometimes added to individual articles.



Required. The git-repo URL allows users to click Edit this page or Log an issue to open the page in GitHub.

This metadata should be added to either the or file.


Example: user-guide-title: Identity Services Admin Guide

Required in the file. Displayed in breadcrumb, search results, and browser tabs. We recommend that the user-guide-title use the same text as the page title (such # Identity Services Admin Guide {#admin}).


Example: user-guide-description: Learn how to administer users and products for Identity Services.

Required in the file. When Experience League landing pages are generated, the user-guide-description value is pulled from the file.

We recommend you limit the user-guide-description value to one sentence with no more than 20 words.

breadcrumb-title: Components Guide

This text is used in the guide breadcrumb that appears at the top of the page. Specify the breadcrumb-title in the file. It’s usually shorter than the user-guide-title.


Not required. You can specify seo-title if you want it to be different from title when displayed in search results.


Not required. You can specify seo-description if you want it to be different from description when displayed in search results.

Metadata Not Yet in Use


Example: audience: administrator

Default is all. Currently not in use, but will likely be used in the future with specific ENUM values such as all, administrator, analyst, marketer, implementer, developer, architect, author.


Example: difficulty: 3

ENUM values 1, 2, 3, 4, 5. 1=beginning, 3=intermediate, 5=advance. To be used primarily for videos and tutorials, not help articles.


Example: doc-type: troubleshooting

Default is reference. Currently not in use, but might be used in the future with specific ENUM values such as developer, troubleshooting, tutorial, reference, video, white-paper, release-notes. See also type above.

(Note: Tech marketing = understand, use, setup, implement, troubleshoot, develop)


Example: badge: premium

We used this term during migration for Target to flag premium content so we could add a “Premium” badge image to the title. This metadata is used only for reference at this time.

If you want a badge for your solution, contact the SSE team.


Example: version: 6.4

Primarily for AEM and Campaign. Not yet used. When in use, likely ENUM values are 6.5, 6.4, 6.3 and 6.2 for AEM and v6 and v7 for Campaign Classic.


Example: author: John Doe`

Not yet used.


Example: last-updated: n

Default is yes. If you change the metadata to “last-updated: n”—-such as for minor changes—-the “Last updated” date in the right rail will not be updated. Not yet implemented.


Example: private-beta: y

Default is no. Not yet in use.


Example: private-feature-pack: y

Not yet in use. For AEM, we might use Private Feature Pack and Admitted Domains from helpx. Default is no. If you select this option, admitted-domains is also required. We should verify admitted-domains is specified if private is enabled. Don’t allow publish if not specified.


Example: admitted-domains: <string>

Not yet in use. Required for AEM private feature packs.

legacypath For AEM


Example: internal: y

For KB docs. Default is no. Way to publish content for Adobe tech support operators only. Not yet in use.


Example: feature: asset-insights

Primary DX feature name. Set values for each solution? Proposed by tech marketing team.


Example: topic: implementation

Cross feature use cases and capabilities/themes for DX products. Set values for each solution? Proposed by tech marketing team.


Example: activity: asset-insights

Understand the intended use of the page. Set values for each solution? understand, use, setup, implement, troubleshooting, developer. Proposed by tech marketing. similar to doc-type and audience


Example: previous: <URL>

Show previous article in tutorial thread. Proposed for tutorials.


Example: next: <URL>

Show next article in tutorial thread. Proposed for tutorials.





kt (Example: kt: <jira-number>)


Example: cloud: experience-cloud

Not yet in use. When used, proposed ENUM values include experience-cloud, marketing-cloud, analytics-cloud, advertising-cloud.

Deprecated (or soon-to-be deprecated) Metadata


Unique page ID used for post-migration redirects. Do not copy to another file.


Example: solution-title: Learn & Support

Required for AEM. Not used for EXL. This item is the link text for the first of three links in the header. For standard help guides, use “Learn & Support” unless you need to create a link to different content.


Example: solution-hub-url:

Required for AEM. Not used for EXL. The hub URL determines the link destination when users click the Product name in the user guide header.


Example: solution-icon: assets/logo-24.png

Never used. Intended to be used for solution icon in the header.


Example: getting-started-title: Getting Started

Required for AEM. Not used for EXL. This item is the link text for the second of three links in the header. Use “Getting Started” unless you need to create a link to different content.


Example: getting-started-url:

Required for AEM. Not used for EXL. The getting started URL determines the link destination when users click the middle link in the header.


Example: tutorials-title: Tutorials

Required for AEM. Not used for EXL. This item is the link text for the third of three links in the header. Use “Tutorials” unless you need to create a link to different content.



Required for AEM. Not used for EXL. The tutorials URL determines the link destination when users click the third link in the header.


Example: user-guide-url: /content/help/en/audience-manager/user-guide/aam-home.html

Never used. Ignore.

Landing Page Metadata (EXL)

Landing Page Metadata is EXL only. We use metadata in landing pages to define the breadcrumb experience.

Breadcrumb format:

Home > [Solution] > [Guide Name] > [article-name].html

Home jumps to the main AdobeDocs landing page. Likely

Solution jumps to the solution landing page, such as Analytics or Experience Platform.

Guide Name jumps to the home page of the user guide.

The article name is not a link.


breadcrumb-name: Analytics

Required. The breadcrumb name should be the solution landing page name, such as Analytics or Experience Platform. This name will appear in the breadcrumb for any content assigned to that landing page as a child repo.


child-repos: id-service, core-services, core-services-learn, device-coop

Required. Add the repo names (no language suffix) to the child-repos metadata on the landing page. Any content within a child repo uses the breadcrumb information from the landing page in which the child-repo is specified. For example, if “id-service” is added as a child repo to Core Services, any ID Service article will have this breadcrumb:

Home > Core Services > ID Service User Guide > article name

A repo can be added as a child repo to only one landing page (although the repo can be linked to from multiple repos).



This is used for special tutorials landing pages (or possibly sub-landing pages) to make sure the appropriate landing page appears in the breadcrumb.

On this page