Tag content using ExL Authors extension

This guide explains how to add metadata tags your markdown content using the Experience League (ExL) Authors extension in VS Code.

Useful links

Notes

  • Do not manually edit metadata or remove v1 values.
  • Topic tags are not being used currently. Ignore this field until further notice.
  • A product tag is required for each page. You can add product to the metadata or TOC file in your repo.

What’s new in ExL Authors extension whats-new

See the release notes wiki.

Edit a single file single-file

You can add metadata tags to a single file. Use cases:

  • Add a product tag to the metadata.md or the TOC.md file

  • Add a role tag to an article or TOC.md

  • Add a feature tag to an article

    note important
    IMPORTANT
    Adding a tag (such as product) to metadata.md causes all articles in the repo to inherit the tag. Adding a tag in the TOC.md file displays the tag on all files referenced in the table of contents. Article-level tags supersede metadata.md and TOC.md values.

To add a tag to a single file

  1. Download and install the latest Experience League (ExL) Authors extension VSIX file in VS Code Extensions.

  2. In your repo, open the file.

  3. Click Edit Metadata.

    Edit Metadata

  4. In the IA Metadata panel, click Add (the plus icon) for product.

  5. Save the file.

NOTE
If your product is missing, reach out to Tracy Forzaglia.

Work with tags review-tags

To launch the auto-tagger, click Adobe EXL Authors (in the sidebar), then click Review tags.

Launch auto-tagger

The Review Tags interface displays files and data about each file (file name, folder, tags found, and review status).

Review Tags

Descriptions:

  • Review Tags: (The main UI) Lets you find and add tags.

  • Keyboard shortcuts:

    • alt-t or opt-t to open a new Add tags to selected files panel. This panel lets you quickly add tags with smart filtering.
    • Copy tags from one file and paste (apply) them to others.
    • opt-A or alt-A to launch auto-tagging for all visible files in a folder.
  • Filter: You can filter files by missing tags, folder, or review status. You can also search for specific files.

  • Select files: You can use the space bar to select articles when mousing over them.

  • Copy, paste, or add tags: Lets you perform these actions on files, or quickly access the Add Tags panel.

  • Autotag: Opens the IA Metadata panel. It’s an intuitive interface that lets you review, remove, and add tags.

    IA Metadata

    Use IA Metadata to add and remove all tag types.

    You can also browse and search the Taxonomy Glossary to verify whether tags exist.

Quick tag

This panel lets you quickly add tags with smart filtering and apply tags to multiple articles.

You can open the Quick tag panel in IA Metadata. Or, open it by selecting files, then using Opt-T or Alt-T shortcuts.

IA Metadata

Tag automatically

In the IA Metadata panel, click Tag Automatically.

This option automatically determines appropriate tags for the article, based on tags in Top Quadrant (glossary).

Autotag batches of articles

You can apply, save, and mark reviewed tags on batches of files (all the filtered articles on the Review Tags table). Tags are generated and validated for each file. Files are saved automatically.

  • In the Review Tags panel, click Autotag.

    IA Metadata

How-to videos

recommendation-more-help
authoring-guide-help-main-guide