openedx / openedx/frontend-app-authoring

Bulk migrate LegacyLibraryContent Block references

Open
#2,758 6 comments 0 reactions 1 assignee View on GitHub

@navinkarkera is already working on this.

Since Dec 19, 2025.

Dominant language
TypeScript
Stars
17
Forks
218
Avg merge
9d 20h
Merged PRs (30d)
20

Description

Hi @navinkarkera!
I don't understand the first question (on a new ItemBank) but I'll try to write out the thinking; maybe this will answer the questions?

The current flow to shift to new content libraries from legacy libraries is in two steps:
First: migrate the legacy libraries from the legacy library home page
Second: for randomized content blocks, click the below "Update References" button on a randomized content block to update the reference to point to the v2 library content

Image

The alert in question here that appears in a course on the Content > Libraries page is an alternative way to complete the second step in bulk. This bulk action is to help in the use case where a course may have many randomized content blocks. It simplifies the flow so users don't need to find each instance of randomized content blocks and click the button each time.

To your question "should we only show the alert for already migrated libraries": yes that's correct. because if the legacy library has not yet been migrated to v2, there are not yet references to update.

Another scenario: if a course had four randomized content blocks referencing four different legacy libraries, and one of those legacy libraries has been migrated, the associated randomized content block should show the "Update Reference" button on the block. Also, on the Library Updates page, there should be an alert with the "update references" banner.

  • In this case, the "update references" button in both places should act the same.
  • If after the one reference has been updated, the remaining three legacy libraries are migrated, each of the three blocks should show the "Update Reference" button.
  • Clicking the "Update Reference" button on a randomized content blick will update only that references.
  • However, on the Library Updates page, the banner button "Update References" should update all three references.

The "Learn More" button should link to this documentation: https://docs.openedx.org/en/latest/educators/how-tos/course_development/migrate_legacy_libraries.html#id8

Originally posted by @edschema in #2386

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.