Skip to main content

​
Overview

The Migrations panel in Admin → Settings is where you run one-off data migrations against your tenant. Each migration includes a Dry Run mode so you can preview the impact before Juno writes any data.
Migrations require the Admin role. They run scoped to your current tenant — they never affect other organizations.

​
Migrate block comments to inline comments

Older content in Juno used block-level comments that attached to entire content blocks. Inline comments — the newer experience — attach to a specific element (a paragraph, an image, a list item) inside the editor and render as a colored highlight you select to open the thread. This migration moves every legacy block comment in your tenant to the inline format, so reviewers and authors see all threads in the same place going forward.

​
When to use it

Run this migration if you want to:
  • Consolidate review activity into one comments experience after upgrading from block comments.
  • See historical block comments inline next to the content they describe.
  • Clean up content that mixes the two comment styles.
You only need to run it once per tenant. Re-running it is safe — already-migrated threads are skipped.

​
Before you start

  • Confirm you have the Admin role.
  • Decide on a scope:
    • Whole tenant — leave both ID fields blank.
    • Single learning unit — provide a Unit ID.
    • Single section — provide a Section ID.
  • Always dry run first. The report tells you exactly how many threads Juno would create and lists anything it would skip, so you can spot-check before committing.

​
Run the migration

  1. Go to Admin → Settings → Migrations.
  2. Locate the Migrate Block Comments to Inline Comments card.
  3. (Optional) Enter a Section ID or Unit ID to limit the scope.
  4. Select Dry Run to preview the changes.
  5. Review the report (see below).
  6. When the dry-run numbers look right, select Migrate Comments to apply.

​
Reading the report

Each run returns a report with the following counts: Migrated threads behave exactly like inline comments you create in the UI — you can reply to them, resolve them, and delete them the same way. Juno tags them internally so that, if needed, support can audit or roll back migrated threads without touching threads you create in the UI.

​
Example: dry-run a single unit

To preview the migration for one learning unit before running it across the tenant:
Migrate Block Comments
The report shows what would happen for that unit only. If the numbers look correct, switch to Migrate Comments with the same Unit ID to apply the change, then re-run with both fields blank to migrate the rest of the tenant.
Last modified on May 24, 2026