What is metadata?

The purpose of metadata is to support the use and searchability of a digital asset. LearningMedia requires content contributors to input mandatory metadata for all types of assets (image, video, audio, interactives, pointer assets, and documents). PBS Education has defined standard formats for ingesting digital assets into the LearningMedia repository and presenting the digital assets on the web. This document outlines the required metadata for LearningMedia and provides editorial guidelines to help you contribute the best metadata possible. 

Metadata spreadsheets

To ensure that you submit all required metadata, the following spreadsheet is provided for your convenience. Use this spreadsheet as a checklist to organize your content and help ensure you are contributing all required elements.

 Click here to open the spreadsheet    

Contractually obligated metadata

Two red asterisks (**) denote contractually obligated information.

A single red asterisk (*) denotes information that MAY be contractually obligated.

 

ElementDescriptionGuidelines  Example
Attribution Image logos that represent anyone who is involved in the creation, funding, or production of resources.  Also represents a brand.   

All media on PBS LM should be branded if it originates from a series. Other institutions can also add branding.  Learn more about Attributions

  • Brand
  • Contributor
  • Funder 
  • Producer
Closed Captioning Text displayed on a television, video screen or other visual display that provides additional or interpretive information to individuals.

Closed captioning is required by the Twenty-First Century Communications and Video Accessibility Act of 2010 on certain video programming delivered using Internet protocol.  

n/a 
*Copyright

A legal designation protecting the publishers control over use and reproduction of their original works.

  • Should include text, year, and ownership information.
  • Format year as YYYY.
  • Do not include the entire date (year, month, day) and time.

© 2013 WGBH Educational Foundation. All Rights Reserved.

Credits Any credits that are contractually obligated to appear alongside the media.  Cheesybreadville used with permission.

Curriculum General Topic

 

The asset's general, high-level topic.  

From the controlled vocabulary dropdown menu, select the topic that most closely reflects what the asset covers.

  • Science
  • Mathematics 
  • English Language Arts and Literacy
  • The Arts
  • Health and Physical Education
  • Preschool
  • Social Studies
  • World Languages
  • Professional Development
Date Available

Date the resource is officially available for publication, broadcast, or distribution.   

  • Format the date as follows: YYYY-MM-DD. 
  • Type the date in manually or click the calendar icon in the CMS to choose a date.

Helpful tip: Click the Today link next to the calendar icon in the admin tool to prefill the date textbox then modify it to reflect the date you want.

2012-11-07  

** Expiration Date

 
The date your content should no longer be viewable on the PBS LearningMedia website.
  • Format the date as follows: YYYY-MM-DD. 
  • Type the date in manually or click the calendar icon in the CMS to choose a date.

(info) If your content should never expire, type 2099-12-31 in the Expiration Date field. 

Helpful tip: Click the Today link next to the calendar icon in the admin tool to prefill the date textbox then modify it to reflect the date you want.

2012-11-07
Grade Level  

Targeted grade level for the asset.  Indicates the grades where the media can most likely be used effectively. Note that while the educational support information may be focused at a particular grade level, the media may potentially be useful to a wider grade band.

Select at least one grade level from the checkboxes provided. Multiple selections are permitted.

PreK, K, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13+ 

Media Type General 

 
General, high-level asset type.Choose the type of media that reflects what you are adding to PBS LearningMedia.  
  • Audio
  • Video
  • Image
  • Document
  • Interactive
  • Webpage 
Media Type Specific 

Paired with Media Type General, this field further identifies the media type.

Choose the type that most closely reflects the type of media you are adding to PBS LearningMedia.

(info) This field changes according to what is selected in the Media Type General dropdown menu.

Animation

** Rights Distribution

Indicates if the asset can it be displayed and made available for distribution in a commercial service.

This is a legally sensitive field.  Please check with your legal contact if you are unsure what to choose.  
  • Commercial
  • Non-Commercial  
** Rights Summary

High-level designation of end-user permissions.

This is a legally sensitive field.  Please check with your legal contact if you are unsure what to choose.  Learn more about Rights Summary
  • Stream Only
  • Stream and Download
  • Stream, Download, and Share
  • Stream, Download, Share, and Modify

Short Description

 

Free text field to describe the asset.  Enter general notes, abstracts, or summaries about the digital asset. The information may be in the form of a paragraph giving an individual description, anecdotal interpretations, or brief content reviews. The asset description supports the use and searchabilty of an asset. 

  • Short descriptions should be approximately 1-2 complete sentences and should summarize the overall instructional goals of the asset.
  • Maximum length is 250 characters including spaces.
  • Avoid using marketing descriptions such as those used in viewers’ guides.
  • Offer readable, concise descriptions in the search results or asset windows.
  • Consider starting each description with an active verb or using “standards type” construction (if audience is PreK–12). You may also incorporate other active verbs into your description as appropriate.
    • Examples of active verbs: adopt, analyze, apply, brainstorm, browse, build, capture, choose, collaborate, compare, conduct, consider, construct, contrast, create, describe, design, detect, develop, discover, discuss, distribute, encourage, engage, evaluate, examine, explore, find, form, identify, incorporate, integrate, investigate, launch, lead, learn, listen, make, match, model, observe, plan, play, practice, predict, prepare, produce, read, reflect, reinforce, research, review, role-play, search, study, teach, use, view, watch, work, write
  • Descriptions should not refer or allude to content not included in the asset. For example, refrain from noting a transcript of a video is available unless the transcript is included with the video’s support materials in the asset group.

The Music Instinct – Frequency Explorer:
Explore music frequency and how it manifests in the sounds around us. Change the frequency balance in common sounds -- such as the sound of a rooster, ferry, lion, and laughter-- and understand the affects the changes have on the sounds.
 

* Source (External) Link 

A courtesy to or a requirement from a third party or source site that provides the content.   

Should be written as a call to action. For example: Find out more about xxx on the American Experience web site. Find out more about the Between the Lions series.
* Source Text 

Metadata that can travel to other places to allow monitoring of the provenance of a media object. It's generally a series title and episode title (or episode number), or some other web site name or organization name.

 
 Between the Lions: "Cheesybreadville & Stolen Smells" 

Title

 
Titles are typically supplied by the original creator of the digital asset. However, when a title is not available, assign a title that is distinctive, authoritative, descriptive, accurate, and consistent. The asset title will be used to represent the asset in the LearningMedia system and on the Web.  Free text name given to the digital asset.
  • A title with a subtitle should be formatted as: Title: Subtitle (title colon subtitle)
  • A title with both a subtitle and a sub-subtitle should be formatted as: Title: Subtitle: Sub-subtitle (title colon subtitle colon sub-subtitle)
  • An asset that is a part of series should include that information at the end of the title in parentheses: "Title (Part 1 of 5)" instead of "Title – Part 1 of 5"
  • A title should be descriptive rather than generic, e.g., do not use "Lesson Plan Number 4."
  • Do not include station call letters in the title.
  • Do not include grade levels in the title.
  • Do not use the file name with extension as the title. For example: “filetitle_000101full_h264.mp4” should be replaced with a descriptive title.
  • Do not include URLs within the title.
  • Do not use words that describe the asset type like “Group” or “Simple” in the title.
  • Additional pertinent information should be placed in parentheses at the end of the title:
    • Examples:
      ∗ Warehouse Puzzle (Level 1)
      ∗ Arches National Park (Segment 2) 

Dragonflies in Kentucky 

 

Required asset metadata

FieldDefinitionExample Required to save
Accessibility Indicators Denotes the different ways an asset can be accessed by users. Provides warning indicators if a resource is not suitable for certain users.  For example, a video marked with a Flashing accessibility indicator is not suitable for a user with sensitivity to flashes.Auditory, Visual (error)
Asset Code An auto-populated code that does not surface on the front end.  This field is for internal use only.   odc08_vid_writers_ch6 n/a
Asset Type 

Regular or Pointer.  A regular asset is an asset that is being created in the PBS LearningMedia CMS.  A pointer asset is an asset that exists on an external website and is being linked to from a PBS LearningMedia resource.

Regular (tick)
AttributionsImage logos that represent anyone who is involved in the creation, funding, or production of resources.  Also represents a brand.   (error)
AudienceDetermines if asset is intended for an Educator and Learner or Educator Only. Educator Only(error)
Available From Date

Date the resource is officially available for publication, broadcast, or distribution.

  • Format the date as follows: YYYY-MM-DD.
  • Type the date in manually or click the calendar icon in the CMS to choose a date.

Helpful tip: Click the Today link next to the calendar icon in the admin tool to prefill the date textbox then modify it to reflect the date you want.

2008-09-11(error)
Content Flags A designation indicating if a resource contains material that is classified as cautionary.Violence, Adult Language  (error)
Content Flags DescriptionAdditional description of designated content flags.  Some brief graphic violence and adult language is included in this resource.  (error)
Content Project The project to which the asset belongs.   Ohio Collection of Video Resources (tick)
CreditsAny credits that appear alongside the media.  Cheesybreadville used with permission. (error)
Date Created The date the asset is created. This field is auto-populated when the asset is saved.2010-09-11n/a
Description This is the description of your asset.  This field is not viewable by users but is useful for your own recordkeeping.   

This video segment adapted from KET's Where the River Bends demonstrates how climate change and glacier movement during the Ice Ages destroyed the old Teays River and created the Ohio River, Kentucky's northern border.

 
(error)
Expiration Date

The date your content should no longer be viewable on the PBS LearningMedia website.

  • Format the date as follows: YYYY-MM-DD.
  • Type the date in manually or click the calendar icon in the CMS to choose a date.

(info) If your content should never expire, type 2099-12-31 in the Expiration Date field.

Helpful tip: Click the Today link next to the calendar icon in the admin tool to prefill the date textbox then modify it to reflect the date you want.

 
2008-09-11(error)
Media The physical media file. coyote_video.mp4 (tick)
Media Type General Defines the type of media you are adding to the asset.  There are five available media types: Audio, Document, Image, Video, Webpage, and Interactive. Video (error)
Media Type Specific A qualifier for the type of media you selected in the Media Type General dropdown menu.  The Media Type Specific menu is populated based on what is selected in the Media Type General menu.Animation (error)
Poster Image A high quality image intended for use in several areas of the asset.  The poster image appears as a thumbnail on search results and appears as the image on the main video of your resource.   n/a (tick)
Rights CopyrightCopyright information including year and source.  Additional copyright text can be included such as "All Rights Reserved" as well as a copyright symbol (©).  © 2005 (tick)
Rights DistributionDetermines if an asset is used for commercial or non-commercial use.Non-commercial (tick)
Rights Summary

High-level designation of end-user permissions.  Options include:

  • Stream Only
  • Stream and Download
  • Stream, Download, and Share
  • Stream, Download, Share, and Modify

Stream, Download, and Share

(tick)
Slug 

Boosts SEO and reflects website best practices.  It appears as the last part of the URL in the browser address bar.  It is auto-generated from the Title field upon initial save of the asset.

dragonflies-in-kentucky n/a
Source

Metadata that can travel to other places to allow monitoring of the provenance of a media object. It's generally a series title and episode title (or episode number), or some other web site name or organization name.

 
Between the Lions: "Cheesybreadville & Stolen Smells"  (error)
Title The title of your asset.  Use this title to search for the asset when adding it to a resource.

Dragonflies in Kentucky 

 
(tick)
TypeIndicates if your asset is Regular or Pointer. Regularn/a

Required resource metadata

FieldDefinitionExample Required to saveRequired to publish 
AttributionsImage logos that represent anyone who is involved in the creation, funding, or production of resources.  Also represents a brand.    (error)(error)
Audience Designates for whom the content is intended.   Educator and Learner. (tick)(tick)
Available From Date 

Date the resource is officially available for publication, broadcast, or distribution.

  • Format the date as follows: YYYY-MM-DD. 
  • Type the date in manually or click the calendar icon in the CMS to choose a date.

2012-12-09 

 
(error)(error)
Content Flags A designation indicating if a resource contains material that is classified as cautionary. Violence, Adult Language (error)(error)
Content Flags Description Additional description of designated content flags. Some brief graphic violence and adult language is included in this resource. (error)(error)
Content ProjectThe project to which the resource belongs.  Finding Your Roots (tick)(tick)
CorrelationsResources are correlated to standards via the Curriculum Hierarchy.  Curriculum Hierarchy is required metadata.humans :: health :: agriculture and food productionpopulations and ecosystems :: human impactearth system :: environment :: water pollutionearth system :: environment :: pollutionearth system :: environment :: land and water useengineering and technology :: topic :: agriculture1960s and 1970s :: United States :: General :: Environment(error)(error)
Curriculum Hierarchy

Teaching standards that prescribe what teachers should teach and what students should learn in the classroom.

Learn more

Water Quality:  Science > Earth and Space Science > Water Cycle, Weather, and Climate (error)(tick)
Expiration Date 

The date that the resource expires and is removed from public view.

  • Format the date as follows: YYYY-MM-DD.
  • Type the date in manually or click the calendar icon in the CMS to choose a date.

(info) If your content should never expire, type 2099-12-31 in the Expiration Date field.

2012-12-09  (error)(error)
Geo-restrictionsSpecifies if the resource availability should be limited. Choose United States to make the resource viewable only in the United States or None to make it viewable everywhere.United States (error)(error)
Grades The grades for which the resource is considered appropriate.  Grade range is from PreK to 13+.PreK, K, 1, 2, 3 (tick)(tick)
Keywords Words that are used to describe the resource. Keywords should be separated by commas.mass, conservation, chemistry, Regents Exam(error)(error)
Language The language in which the resource is available.  The language is pulled from the Asset and automatically added to the Resource.  It cannot be changed at the Resource level.Englishn/an/a
Learning Objective A brief summary that tells a teacher how to use the resource.  Cannot exceed 250 characters including spaces. This video lays down the law and provides essential information needed for the Regents Exam. (error)(error)
Long Description (previously Synopsis) Long description is three to four sentences long and approximately 650 characters including spaces. It begins by describing the resource (both its media and content theme) and then provides users with a clear explanation of what they can expect to see in the resource. Thus, if users cannot view the resource at that moment, it’s still possible to discern its utility in the classroom. To help with search-engine retrieval, try to include key terms in the long description that you might expect users to be searching for. If you mention a series title as the source of the media, the title should be in italics
 Click here for example

“Cell Division”?

This interactive activity adapted from the Exploratorium takes you through a process that is critical to life—cell division. Division enables cells to replicate their genetic material and then create an exact copy of themselves. Explore the individual steps of this process, by which single-celled organisms reproduce and multicellular organisms develop, grow, repair damaged tissue, and reproduce.

(error)(tick)
Meta Description

Generates the descriptive snippets in search listings and on social media sites. This text should complement the Title Tag and entice users to click the link. A missing or badly formatted description will result in very low click-through rates. If no meta description is added, a default description will be added as follows:

Digital classroom resources from [producer name] for Grades [grade level].[Short description].

Digital classroom resources for Grades K-6. Tutorial to create EC Lesson Plans.(error)(error)
Primary AssetA type of resource that can include a video, document, or other media object with associated supporting assets.  Assigned when creating a resourcePoisoned Waters: What Is the Biggest Polluter of Water? (error)(error)
Publication Date

Date the resource is officially available for broadcast or distribution.

  • Format the date as follows: YYYY-MM-DD.
  • Type the date in manually or click the calendar icon in the CMS to choose a date.
 
2013-09-09   (error)(error)
Related ResourcesResources that are related to and serve as supplemental information to the primary Resource.  Related Resources are located in the right column of a Resource page in LearningMedia and are labeled Related Content. (error)(error)
Resource CodeAn auto-populated code that does not surface on the front end.  This field is for internal use only. rr12.sci.chem.mart.lawconmas n/an/a
Short Description (previously Annotation)

Short description briefly explains the content focus of the resource and describes its media type and original source. Cannot exceed 250 characters including spaces. The Short desciption is displayed on listings pages. If you mention a series title as the source, the title should be in italics.

   
 Click here for example

Cell Division

In this interactive activity adapted from the Exploratorium, explore the step-by-step process by which an animal cell divides to make more cells.


How The Ohio River Was Formed ?

This video segment adapted from KET's Where the River Bends demonstrates how climate change and glacier movement during the Ice Ages destroyed the old Teays River and created the Ohio River, Kentucky's northern border.

(error)(tick)
Slug An auto-populated field that surfaces at the end of the URL string in a browser address bar.law-of-conservation-of-massn/an/a
Source GuidAn auto-generated code that is used for database purposes. Do not pay attention to this field. n/an/a
Support MaterialsItems that are used to support the main resource.  Can include handouts, additional videos, lesson plans, and more.  Can be added manually or as an attached file.
 Click here for example

Background Essay:

What Is the Biggest Polluter of Water?

Flying in a four-seat Cessna over the Eastern Shore of the Chesapeake Bay, Rick Dove sees a world unknown to most: mound upon mound of chicken manure. Dove, a pollution detective for the Waterkeeper Alliance, is keeping close tabs on those mounds out in the open, because when it rains, that manure has one place to go - downstream into the Bay that he’s trying to protect.

The Chesapeake’s Eastern Shore is the site of massive industrial agriculture. It produces more than 570 million chickens a year which create 1.5 billion pounds of waste, more than the human waste from the cities of New York, Washington, San Francisco and Atlanta combined. “Agriculture is by far the largest source of pollution to the Chesapeake Bay and it is arguably the single biggest source of pollution to all the waters in the country,” says Chuck Fox, the EPA’s senior adviser on Chesapeake Bay.

While the Clean Water Act targeted pollution coming out of a pipe from city sewage and industrial plants, waste flowing off of farmland was left largely unregulated. Unlike industry, no specific pollution discharge limits were set. “The whole agricultural community has remained maybe the last big unregulated area of water pollution,” says Tom Horton, author of several books on Chesapeake Bay. With the deregulation movement of the 1980s, the EPA and the rivershed states tried to combat farm pollution through voluntary programs - a solution that farmers advocated but environmentalists said lacked the teeth of enforcement.

What makes the problem acute is the concentration of agriculture waste. Tens of thousands of chickens are raised on one large shed; millions on one family farm. In Pennsylvania, cows per farm increased five-fold between 1954 and 1997. Nationwide, industrial agriculture now produces more than three times the raw waste of humans.

With falling meat prices and Americans’ insatiable protein-rich appetite (we now consume three-times as much poultry as in the 1950s), pollution from animal waste has become a formidable problem. Explains Jim Perdue, CEO of Perdue Farms: “Things had to become bigger in order to keep costs lower.”

But leading activists like Robert Kennedy Jr., chair of the Waterkeeper Alliance, say that companies like Perdue and Tysons are not paying their true costs of production. Kennedy argues that they have dumped the cost burden of cleaning up animal waste on taxpayers.

So activists like Dove and Kennedy are attempting to force a clean up through a provision in the Clean Water Act that allows citizens to sue polluters and the government. In 2003 and 2008, Waterkeeper Alliance filed suit against the EPA and Maryland, to try to toughen regulatory oversight. Lately, under President Obama, the EPA has begun to require pollution discharge permits for the large poultry farms.

Background Essay Written by Hedrick Smith.

(error)(error)
TaxonomyA hierarchical classification used to organization and arrange resources.National K -12 Subject::Science::Earth and Space Science::Water Cycle, Weather, and Climate::Water Quality(error)(error)
Title The title of the resource.  In a browser, appears at the top of the resource and clicks through to the actual resource. Law of Conservation of Mass (tick)(tick)
Type Denotes if resource is Lesson plan; One primary asset; Media gallery; or Self paced lesson. One primary asset (tick)(tick)

If assets are submitted in groups (e.g., a video with an associated lesson plan), a separate metadata record that includes all of the mandatory metadata must be created for the group.