Migrate Training Key Pool Keys to Course Assignment Training Keys

Prev Next

Training Key Pools are being sunset in the Skillable Training Management System (TMS). To ensure students can still redeem keys that have already been distributed, any unredeemed keys from Training Key Pools must be migrated to Course Assignment Training Keys.

Overview

If your Organization has previously distributed Training Key Pool keys that have not yet been redeemed, those keys must be recreated as Course Assignment Training Keys.

Because each training key code must remain unique in the TMS, keys cannot be directly reused while they still exist in a pool. To migrate them successfully, you must:

  1. Copy the existing keys.

  2. Remove the keys from the Training Key Pool.

  3. Recreate the keys as Course Assignment Training Keys.

Once recreated, the keys remain valid and will still be recognized by TMS when students redeem them.


When Migration Is Required

You should migrate keys if:

  • You previously distributed keys from a Training Key Pool.

  • The keys have not yet been redeemed by students.

  • You want those keys to remain valid after Training Key Pools are retired.


Before You Begin

Recommendation
Export the keys from your Training Key Pool before making changes. This allows you to keep a backup record of the original keys for tracking and verification.


How to Migrate Keys from Training Key Pools

Step 1 — Open your Training Key Pool

Navigate to:

TMS Site Administration → Training Keys → Training Key Pools

Select the Training Key Pool that contains the keys you want to migrate.

Search interface displaying training key pools with results and details options.


Step 2 — Export Existing Keys

Within the pool details:

  1. Click Export.

Overview of training keys with details on expiration and redemption dates.

  1. Download the exported spreadsheet.

Spreadsheet displaying training keys, user details, and redemption dates for assessments.

Notes:

  • The spreadsheet and worksheet tab will be named after the pool.

  • Select the Undistributed Keys list.

  • Copy the keys you want to migrate to your clipboard.


Step 3 — Delete Keys from the Pool

Important
Keys must be removed from the Training Key Pool before they can be recreated. This prevents duplicate key codes in the TMS.

  1. In the Training Key Pool, locate the keys you copied.

  2. Click Delete beside each key to be migrated.

  3. Save the pool.

List of training keys with creation and redemption dates for user management.

The pool will still retain records of any previously used keys.

Overview of training keys for the course 'Gating through Assessments' with details.


Step 4 — Create a Course Assignment Training Key

Navigate to:

TMS Site Administration → Training Keys → Course Assignment Training Keys

Click Create.

Enter the following information:

  • Course

  • Organization (modify if needed)

  • Expiration Date for when the keys must be redeemed

  • Max Uses Per Key (leave blank for single-use keys)

  • Content Availability (adjust as needed)

Save the entry.

Form for creating course assignment keys with various input fields and options.


Step 5 — Add the Migrated Keys

Within the newly created Course Assignment Training Key:

  1. Open the Training Keys tab.

  2. Click Add Multiple Training Keys.

  3. Paste the copied Training Key Pool keys into the field.

  4. Click Save.

The keys are now recreated as Course Assignment Training Keys.

Interface for creating course assignment keys with options for adding multiple keys.


Step 6 — Verify the Migration

After saving:

  1. Navigate to Find Course Assignment Keys.

  2. Confirm that the newly recreated keys appear in the list.

You can verify successful migration by:

  • Redeeming one of the migrated keys in TMS.

  • Comparing the recreated keys against the exported spreadsheet.

Search interface displaying course assignment keys and results for training programs.


Result

Once migrated:

  • The keys remain valid for student redemption.

  • The keys are now managed under Course Assignment Training Keys instead of Training Key Pools.

  • Students can continue using the previously distributed codes without disruption.


Frequently Asked Questions

What happens to Training Key Pool keys that haven’t been redeemed?

Training Key Pool keys that have not been redeemed will become invalid when Training Key Pools are retired.

If keys have already been distributed to students but have not yet been redeemed, they must be migrated to Course Assignment Training Keys by April 10, 2026 to remain valid.

Keys that are not migrated before this deadline will no longer be redeemable once Training Key Pools expire.

Will existing keys still work?

Yes, but only under certain conditions.

  • Migrated keys will continue to work normally.

  • Keys in active Training Key Pools will work until the pools expire.

  • Keys that are not migrated will stop working once Training Key Pools are removed.

To ensure uninterrupted access for students, any distributed but unused keys should be migrated before the migration deadline.

What will a student experience if a key is not migrated?

If a student attempts to redeem a key from an expired Training Key Pool, they will receive an invalid key error message.

At that point, the administrator will need to issue a new Course Assignment Training Key to the student in order for them to access the course.

What are the cutoff dates and what should be done before each one?

April 17, 2026
Creation of new Training Key Pools will be disabled.

Best practices before this date:

  • Convert all distributed but unused Training Key Pool keys to Course Assignment Training Keys.

  • Set the expiration date on key pools to the current date once keys are migrated.

  • Create all new keys as Course Assignment Training Keys.

May 8, 2026
Training Key Pools become read-only.

Administrators will no longer be able to add or remove keys or modify pool settings.

Best practices before this date:

  • Ensure all distributed but unused keys have been migrated.

  • Expire all Training Key Pools.

  • Export any key usage records you want to retain.

May 29, 2026
Training Key Pools will be fully removed from the system.

Before this date:

  • Export any key history you need to retain.

  • Confirm all keys are managed through Course Assignment Training Keys.

How do we migrate unused Training Key Pool keys?

To migrate unused keys that have already been distributed:

  1. Export or copy the keys from the Training Key Pool.

  2. Delete the keys from the pool to prevent duplication.

  3. Create a new Course Assignment Training Key entry.

  4. Paste the copied keys into the Add Multiple Training Keys field.

  5. Save the new keys.

Once migrated, the keys remain valid and will continue to work when students redeem them.


Summary

Migrating distributed but unredeemed Training Key Pool keys ensures they remain valid after Training Key Pools are retired. By recreating keys as Course Assignment Training Keys, you can maintain uninterrupted access for your users. Completing this process before the cutoff dates helps prevent access issues and ensures a smooth transition.

If you’re experiencing an issue with a lab, platform feature, or your account, please submit a ticket to Skillable Support. Our Support team can help you troubleshoot errors, resolve access issues, and answer questions specific to your environment.

If you noticed an error or have suggestions for improving this documentation, use the Was this article helpful? section below. Your input helps us keep our documentation accurate and up to date.

Was this article helpful?

Please note that this feedback is for documentation only. Be sure to log in to your Skillable account when leaving feedback so we can respond directly.