Skip to content

Taxonomies & Skills

Overview

Taxonomies & Organization covers tools for categorizing and organizing course content and metadata — including content tagging (applying taxonomy tags to courses and content blocks), taxonomy management, and course organization metadata (language, level, subjects).

This is a newer feature area in Open edX. Content tagging and taxonomy management were added as part of the broader openedx-learning initiative and are now available in frontend-app-authoring.

Current State (2026)

  • Tagging UI: Authors can tag courses and individual content blocks with taxonomy tags directly in frontend-app-authoring
  • Taxonomy management: Taxonomies (hierarchical controlled vocabularies) defined and managed via Django admin or the taxonomy API
  • System taxonomies: Open edX ships with some built-in taxonomies (languages, difficulty level); operators can add custom ones
  • Tag search: Tags can be used to filter content in library and course search
  • OEP alignment: Taxonomy system designed to align with OEP-40 (Tags and Taxonomies)

Architecture

  • Backend: openedx-learning provides the taxonomy and tagging data model; REST API for CRUD operations on taxonomies and tags
  • Frontend: frontend-app-authoring renders the tagging sidebar; calls openedx-learning APIs
  • Scoping: Taxonomies can be scoped to organizations or made system-wide
  • Extensibility: Custom taxonomy sources (e.g., external SKOS vocabularies) can be integrated

Relevant Repositories

RepositoryRole in This FeatureActivity LevelNotes
openedx/frontend-app-authoringTagging sidebar UI, taxonomy management pagesHighMain frontend
openedx/openedx-learningTaxonomy and tagging backend (OEP-40)HighData models + API
openedx/openedx-platformCourse metadata fields (language, level, org)HighLegacy metadata
openedx/edx-organizationsOrganization managementLowOrg scoping

Recent Changes

  • Content tagging feature actively developed and released in recent Open edX named releases
  • Taxonomy API stabilization

History

Origin

  • Year introduced: ~2023 (content tagging as a distinct feature)
  • Initial implementation: Simple course metadata fields (language, level, subjects) existed from early edX; structured taxonomy system is much newer
  • Context: As course catalogs grew to thousands of courses, discovery and organization needed structured metadata

Key Milestones

YearMilestoneTeams / People Involved
EarlyCourse metadata fields (language, level) in course settingsUnknown
~2022–2023OEP-40 (Tags and Taxonomies) proposal and developmentUnknown
~2023–2024Content tagging UI released in frontend-app-authoringUnknown

People Who Shaped This Area

  • Engineering: Unknown — open question for interview
  • Product: Unknown — open question for interview
  • Design: Unknown — open question for interview

Open Questions

  • [ ] What was the product case for building a full taxonomy system vs. simpler tagging?
  • [ ] Who authored OEP-40 and what was the design process?
  • [ ] How are taxonomies being used in practice by early adopters?
  • [ ] How does tagging integrate with search and catalog discovery?
  • [ ] What external taxonomy standards (SKOS, Dublin Core) influenced the design?

Schema Education — Internal Research