Repository navigation
Open
Description
Note
This issue and the linked plan were drafted by Claude Fable 5.2 under direction from @kdmccormick, who has not yet reviewed them in detail.
Part of the Legacy Content Libraries (V1) deprecation, under the epic openedx/frontend-app-authoring#2044.
Why
The post-Verawood removal step of the deprecation was only partly carried out. An audit of current master found that:
- The legacy library view/edit page is still served at
/library/<key>, andPOST /library/still creates a legacy library. - The legacy Randomized Content Block (
library_content) still has its whole authoring side: the library picker, the problem-type filter, and "Update now". - Several Studio APIs still accept
library-v1:keys, and a number of toggles, settings and Studio Home API fields exist only for legacy library authoring.
This issue tracks removing that code. It follows on from #38056 and #38058.
What stays until after the Xylon cutoff
- Storage of legacy libraries in the modulestore.
- Learner-side rendering of existing Randomized Content Blocks, and their remaining settings.
- Migration to Content Libraries in every form (the Studio workflow, the REST API, Django admin, management commands), including "Update reference" on a Randomized Content Block.
- The legacy libraries listing API, and OLX export of a legacy library.
Plan
Full plan: https://gist.github.com/kdmccormick/6f37a6f32fba1498fc8cd5b71d5cde67
Audit it is based on: https://gist.github.com/kdmccormick/57f0cc18f6f151ee6718331ba73e55b9 (see 05-legacy-libraries.md)
The platform PRs are stacked in the order shown.
| # | Repo | Removes | Status |
|---|---|---|---|
| 1 | openedx-platform | The legacy library page, library_handler, the listing's per-library url field, and the JavaScript only that page loaded |
PR Needed |
| 2 | openedx-platform | Preview plumbing that only the library page used: paging, placeholders, LibraryRoot's Studio rendering |
PR Needed |
| 3 | openedx-platform | Legacy-library support in the remaining Studio write paths: /xblock/ create and duplicate, course_team, course import routes and tasks, the import_content_library command, git export of a legacy library |
PR Needed |
| 4 | openedx-platform | The Randomized Content Block's authoring side, leaving rendering and migration. Adds a validation message for unsupported blocks and a new class docstring | PR Needed |
| 5 | openedx-platform | LegacyLibraryToolsService and its Celery tasks, replaced by one helper that copies children on duplicate, paste and course import |
PR Needed |
| 6 | openedx-platform | Unread legacy-library fields in the Studio Home API, and the toggles and settings tied to legacy libraries | PR Needed |
| A | frontend-app-authoring | Legacy library leftovers: unused fields, legacy branches in the block editors, an unrendered alert, unused Redux state | PR Needed |
Behaviour changes to announce
GETandPOST /library/...in Studio return 404. Legacy libraries can no longer be created through Studio.course_team, course import and/xblock/create and duplicate stop acceptinglibrary-v1:keys. Theimport_content_librarycommand is removed, andgit_exportno longer accepts a legacy library key.- The Randomized Content Block's library and problem-type settings become read-only, and "Update now" is removed. In the component picker it is named "Legacy Randomized Content Block (Deprecated)". A block with no source library shows an error telling the author to use a Problem Bank instead.
GET /api/contentstore/v1/homeloseslibraries,libraries_enabled,libraries_v1_enabled,show_new_library_buttonandsplit_studio_home.- The waffle flag
contentstore.new_studio_mfe.disable_legacy_librariesand the settingsDISABLE_LIBRARY_CREATION,ENABLE_LIBRARY_INDEXandLIBRARY_BLOCK_TYPESare removed. Legacy libraries that can be migrated are always listed.
Open points
- The wording of the warning on a Randomized Content Block whose source library has not been migrated yet (PR 4) is a placeholder and needs a product decision before merge.
- PR 6 changes the Studio Home API schema, which overlaps [API] Home Page Data — schema deprecation of GET /api/contentstore/v1/home #39263 and fix: Studio v3 home: no write on GET, no-op org, public schema #39310.
Metadata
Metadata
Assignees
Labels
No labels
Activity
kdmccormick commentedon Nov 12, 2026
FYI @feanil