Open edX Proposals Index

OEP (pronounced “oh-epp”) stands for Open edX (Enhancement) Proposal. An OEP is a document that details a specific technology decision being made by the Open edX community, in the form of a best practice, architecture design, or process adjustment. An OEP should provide the use cases and rationales that surround that choice. OEPs are not the only way for a change to be made to Open edX, however, the goal is to create a collection of OEP documents as a repository or knowledge archive of large and broadly relevant choices made for the platform.


This is the listing of all Open edX Proposals (OEPs). If you are looking for OER Enhancement Proposals, please visit



OEPs that relate to processes we want to put in place for the Open edX community.

Best Practices

OEPs that relate to best practices that you should follow when working with the Open edX Platform. These are guidelines and not requirements. Use them unless you have a good reason not to.

Architectural Decisions

OEPs that capture architectural decisions that impact the entire Open edX Platform. These are decisions that are sufficiently cross-cutting that there is no clear code repository where they should reside.

Indices and tables