Libraries Getting Unlinked After Course Import – Expected Behavior or Bug?

Hello Community,

I would like to seek clarification regarding the behavior of library linking during course import in Open edX.

Background / Context

We are working with library-based courses. As part of our deployment process:

  1. Libraries are released first from the development environment.

  2. The course is then exported and imported into another environment (e.g., staging or production).

However, after importing the course, we are observing that the linked content libraries are getting unlinked. As a result, we must manually relink the libraries for each module, which significantly increases manual effort and delays the release process.

User Story

  • As a course creator, I want the process of releasing library-based courses to be streamlined so that manual effort during course imports is minimized.

  • When releasing an updated version of a course, I expect linked libraries to remain intact after import, so the release process is not delayed by manual relinking.

Expected Behavior

Based on prior understanding and internal discussions, linked libraries should:

  • Remain linked after course import.

  • Automatically update to the appropriate released version without requiring manual intervention.

I have observed that this functionality was previously working as intended, where library links were preserved and automatically updated during course import.

Current Issue

Currently, linked libraries are being unlinked after course import, requiring manual relinking. This appears to deviate from the expected automatic linking behavior.

Questions

  1. Is this the expected behavior in the current Open edX version?

  2. If not, should this be considered a bug?

  3. Are there any configuration settings or best practices we should verify to ensure libraries remain linked during course import?

  4. Has anyone else experienced similar behavior in recent releases?

Any guidance, documentation references, or insights would be greatly appreciated.

Thank you in advance for your support.