Migrate Legacy Libraries to the New Library Environment

Migrate Legacy Libraries to the New Library Environment#

Tags: educator how-to

In Verawood, Legacy libraries will no longer be supported. They are being replaced with the new, fully-featured Library experience introduced in Sumac. The new feature allows you to create any type of content in a library - including content blocks, units, subsections and sections. All content can be reused across courses. To take full advantage of the new features, and to continue using the content in your Legacy Libraries, migrate your Legacy Libraries.

Migrate Legacy Libraries#

  1. Click on the Legacy Libraries tab on Studio Home. You will see a button to Review Legacy Libraries.

    The "Review Legacy Libraries" button appears in a warning panel above the list of Legacy Libraries.

  2. Select which Library you wish to migrate. Click the checkbox next to the Library title to select a Library. You may choose one Library at a time, or multiple Libraries at once.

    Note

    You can use the search bar to find libraries by keyword, or the filter to scope your view to unmigrated libraries.

    Click Next.

    The Migrate Legacy Libraries screen, including a search box, filter for migration status, and a list of Legacy Libraries.

  3. IF you wish to migrate your Legacy Library to a brand new Library, click + Create New Library.

    The "Select Destination" screen, with the "Create New Library" button highlighted.

    Provide the new Library a name, organization and ID and click Create, then click Next.

    The "Create New Library" screen, with name, organization, and ID fields visible.

  4. IF you wish to migrate your Legacy Library to an existing Library, click the radio button next to the title of the Library you wish to select and click Next.

  5. Review the migration details and click Confirm.

    The Confirm screen, indicating which library/libraries have been selected and their destination.

  6. You will be redirected away from the Legacy Library environment to the new Library environment. Your Legacy content will now be populated in the new Library.

Confirm Legacy migrations are complete#

  1. Navigate to the Legacy Libraries tab on Studio Home. Each migrated Library will contain a redirect link.

    The Legacy Libraries homescreen. Each migrated Legacy Library contains an indicator on its card that it's been migrated.

Update course content referenced in Legacy Libraries#

  1. Navigate to the unit page of the course that references Legacy Library content. You will see a notification that the Library is no longer supported and needs to be updated in order to sync any future content changes. Click “update reference”.

    Note

    Content in the Library must be published before any references can be synced.

    The Studio Unit page of a piece of content that uses content from a Legacy Library. There is a link to "Update reference" from the Legacy Library to the New Library.

  2. You will now see the content referenced in the course. Any future changes made to the referenced content can now be synced to the course using the Sync Content workflows.

    The unit page after the reference has been updated. At this point, there is no indication that the content used to link to a Legacy Library.

See also

Publish Library content

Create a New Library

Create and edit content in a Library

Create and edit units in a Library

Search for content in a Library

Use content sidebars to manage content

Add Library content to a course

Sync a Library update to your course

Manage Library User Access

Maintenance chart

Review Date

Working Group Reviewer

Release

Test situation

2025-12-05

Product WG

Ulmo

Pass
Contents