OEP 68: Learning Content Identifiers

Hello! I’m seeking review from platform architects and developers on a new OEP :down_arrow:

Abstract

Open edX code has four kinds of identifiers for learning content: Integer Primary Keys,
Codes, OpaqueKeys, and UUIDs. Choosing the wrong kind—or naming it ambiguously—can
cause subtle bugs, broken exports, and painful code reviews. This OEP explains what each kind
is, when to reach for it, and how to name it consistently.

The primary audience is developers working on openedx-core, openedx-platform, and other
repositories that manage learning content
. Plugin developers, site administrators, and
nontechnical Open edX Core Contributors who work with learning content will also find these
concepts useful.

:globe_with_meridians: This is part of a broader “Open edX Core v1.0” effort.

Review :eyes:

Open: Monday, March 23rd, 2026
Closed: Monday, April 14th, 2026 (beginning of day)

3 Likes