FAQ content

Guides: Add custom metadata to a guide

In this article

In HTML, <meta> tags contain metadata that helps search engines find and rank the relevancy of a webpage. These can be found inside the <head> element of a page. (You can read more about meta tags on the Mozilla Developer Network.)

All LibGuides pages are assigned specific Dublin Core metadata by default, which are contained inside of <meta> tags in each page. These include:

  • DC.Title = Guide name
  • DC.Creator = Guide owner's name
  • DC.Subject = Assigned subject category
  • DC.Description = Guide description
  • DC.Publishers = LibApps customer name
  • DC.Rights = Copyright statement, including your LibApps customer name and the year
  • DC.Language = Language code corresponding to your system's base language
  • DC.Identifier = Current page's URL
  • DC.Date.Created = Creation date of the guide
  • DC.Date.Modified = Last updated date of the guide

LibGuides CMS customers can add additional custom metadata to their guides. This can be helpful in a few ways:

  • By adding metadata to your guides, you can take advantage of the LibApps Automagic LTI tool to pull content into your learning management system, such as Blackboard, Canvas, etc. This allows you to connect students to content from LibGuides that is related to their course, embedding the library's resources into the course itself.
  • You can also use metadata to supplement your OAI-PMH feed, as well. Because LibGuides supports the oai_dc metadata format, you can add any of the supported Dublin Core elements to your guides. This metadata will be exposed when your guides are harvested.
  • Additional metadata can improve your guide's search ranking in search engines.
  • You can add tags specific to your search aggregator (this will work as long as those aggregators are indexing your site by crawling it, and is not currently available via XML export).

Adding & managing metadata while editing a guide

  1. Edit your guide and click on the Guide Information () button.
  2. Select Guide Metadata from the dropdown.

Selecting Guide Metadata from the Guide Information dropdown

  1. In the Guide Metadata window, click on the Custom Metadata tab.

The Custom Metadata tab

  1. To add metadata, locate the row with an ID of Add Record and click on "Empty" in the Name column and enter the name for your metadata. This is what appears in the <meta> tag's name attribute.

Editing the metadata Name

  1. Click on "Empty" in the Value column and enter the value for your metadata. This is what appears in the <meta> tag's content attribute.

Editing a metadata value

  1. To make a metadata value public, select its Public checkbox. Enabling this option will include the <meta> tag in the <head> tag of your public guide page. Otherwise, it will only be used internally within LibGuides, such as with the LTI Tool.

Making a metadata value public

Viewing, editing, and deleting metadata

  1. To view your guide's default metadata, click on the Dublin Core tab.
    • This is generated automatically by LibGuides for each guide and cannot be modified.
  2. To edit an existing metadata name, click on it and enter your changes.
  3. To edit an existing metadata value, click on it and enter your changes.
  4. To remove metadata from a guide, click on its Delete button.
    • Please note that changes to public metadata may not be reflected in search engines or discovery services until the next time your site is crawled/indexed.
    • If you are using an LTI value for the LTI Automagic Tool, please note that this may prevent the guide from matching with related courses.
    • Deleting metadata is permanent, but you can always recreate the deleted value if you change your mind later on.

Adding metadata via Admin > Metadata & URLs

Admin users can also add metadata via the Admin > Metadata & URLs settings, individually or via a bulk upload. From there, they can also edit and delete metadata for guides, as well as subjects and e-reserves courses.

  1. Go to Admin > Metadata & URLs.
  2. Click on the Metadata tab.
  3. Click on the  Add Metadata button.

The Add Metadata button

  1. In the Add/Edit Metadata window, select the guide to which to add the metadata.
  2. The Metadata Name field will automatically be set to the LibGuides Metadata Name value from your Automagic Tool settings.
  3. In the Metadata Value field, enter the value for this metadata. This will be the value used to match the guide to your LMS course numbers.
  4. If you would like to include this metadata in a <meta> tag on the public guide page, set the Public? option to Enabled. Otherwise, leave this set to Disabled.
    • When metadata is public, it will be able to be picked up by search engines and other indexing tools.
    • You do not need to make this metadata public in order to use it with the LTI tool.
  5. Click the Save button.

Adding metadata to a guide