Overview: This article will demonstrate to Admins how to migrate from QuickHelp to the BrainStorm platform. Admins will go through the steps below without any disruption to their current end-user experience. 


Pre-Migration Checklist 

  • As part of the launch initiative, admins will get to know the new BrainStorm platform and be prepared to identify launch initiatives that meet the needs of the Admin's organization. 
  • Receive approval for platform communications and integration of Direct Send.
  • Work with the assigned BrainStorm representative to Determine whether to use the Migration tool.
  • If both QuickHelp and BrainStorm platforms are active, end users will see both options in the Teams app. The BrainStorm platform will be the suggested option. BrainStorm recommends leaving this in place but if Admins choose to temporarily unpin the Teams app, Admins can follow this article, but select to remove the app instead of "Add".   

Initiating the BrainStorm Platform Account 

Option I: Using Migration Tool 

  1. Request enablement of migration tool in QuickHelp from Admins' assigned BrainStorm representative. They will notify Admins when the migration tool has been enabled.  
  2. Navigate and sign into the QuickHelp Admin platform -> Settings. Admins will see the migration option screenshot below.
  3. Select the contents to migrate from QuickHelp to the BrainStorm platform, and click the Migrate Now button. Note: The admin that initiates the migration process will be given admin credentials in the BrainStorm platform once the account has been created.  
  4. The migration requests are processed on Fridays. Admins will get an email with instructions to log into the BrainStorm platform after the migration has been completed.   

Option II: Clean Slate   

  1. Admins will need to request a BrainStorm platform account from their assigned BrainStorm representative. 
  2. Admins will provide names and emails for users who need initial administration roles. 
  3. Admins' BrainStorm representative will notify them when the migration from a clean slate has been completed.    

Disclaimer: Access to the links provided below will be available once your BrainStorm account has been set up. 

 Account Administration Preparation   

  1. Ensure that Admins can log in to the BrainStorm Admin portal (https://admin.brainstorminc.com). Admins will need to create a password until their SSO has been configured. (Bookmark the Admin portal.) 
  2. Search in the end user portal (https://app.brainstorminc.com) for the “Manage Your BrainStormPlatform” flow to complete admin training. (Bookmark the end user portal.)  
  3. Provide Account Administrator roles to those who need to set up as Admins during the technical configuration. 
    • Recommend: System Administrator(s) with the ability to perform the following tasks: 
      • Add Whitelisting
      • Add Trusted Sites
      • Administrate active directory settings (Microsoft Global Admin or Google Super Admin)
      • Configure SSO
  4. Create a Group for Account Administrators and provide access to other admins, as well as prioritize the “Manage Your BrainStorm Platform” flow. Admins can exclude the technical configuration admins from this as they will have a technical guide to follow. 
  5. Admins will need to request any additional Packs from the BrainStorm Marketplace.   
    1. BrainStorm User Engagement Pack will send a communication every Tuesday to end users if they have content prioritized as Important or Required. This is recommended and it will be included in the BrainStorm contract. It can be enabled per request through a BrainStorm representative  

Complete the Technical Configuration   

To complete the technical configuration below, please follow the detail BrainStorm support article here

  1. Add Trusted Sites, Enable Direct Send, and Whitelisting BrainStorm IP Addresses.  
  2. Configure Single Sign-On with your Identity Provider (IdP).  
  3. Add company logo.  
  4. Add users using the Microsoft Graph integration, Google integration, or CSV.  
  5. Enable the Microsoft Teams app. Note: If Admins don’t have this on the QuickHelp platform, wait and do this integration after the QuickHelp platform has been sunset.  
  6. Enable other applicable Integrations.  

Secure Executive sponsorship   

  1. Invite Executive Sponsorship for the launch of BrainStorm. End-users need to hear about change from a leader they recognize. 
  2. Identify organizational goals with the Executive Sponsor that are tied to the launch of the BrainStorm platform.  
  3. Film an Executive sponsorship video to welcome end users to the BrainStorm platform, explaining why BrainStorm is an important tool for the organization.  

Create Cross-Functional Adoption Opportunities  

Create a cross-functional adoption council to increase leadership buy-in for BrainStorm across various areas of the business. This council should include diverse representation from various functions in the business (IT, HR, L&D, Communications, Legal, Compliance, Marketing, Sales, etc)  

Expectations of members of the council: 

  1. Understanding of BrainStorm Platform and how it can be leveraged  

  2. Active participation in the structuring of initiatives and content suggestions  

Finalize Goals and Objectives  

  1. Review with organizations' sponsors and cross-functional team, BrainStorm’s four core learning objectives of the digital employee experience. All four areas should be accounted for as the software adoption goals for end users.  
    1. Onboarding: Help new hires onboard quickly by automating training on the tools they need to do their jobs.   
    2. Remediation: Identify undesirable digital behaviors and provide assigned training to mitigate them.   
    3. Transition: Create technology transition plans for switching software.  
    4. Optimization: Leverage Flows to help employees optimize their software usage.   
  2. Determine which software applications or specific features/behaviors admins would like their end users to adopt and align them with one of the learning objectives. This will be used to customize their learning content.  
  3. Determine how the adoption of that software will align with organizational goals.  
    • Common organizational goals are to increase revenue, decrease cost, and mitigate risk.   
  4. Determine how an organization can successfully measure these adoption goals. 

Create Content Strategy  

Provide the best experience by ensuring every end user has content on their home page:    

  1. If Admins utilize the migration tool, their custom content will already be available, and the content will need to be put into Private Packs 
    1. End users will only have visibility to the Private Packs they have a license to. Create separate Private Packs for content Admins who want to be limited to a targeted Group.   
  2. Upload custom content and sort content by following Step 1.  
  3. Utilizing goals and objectives created above to select Flows Admins want to highlight at launch for each Learning Objective 
    1. For some Objectives, the BrainStorm team recommends selecting more than one Flow, if one topic will not cover end users' goals (Onboarding for example, end users will want to cover multiple applications).  
    2. In the Content -> Flows section of the BrainStorm Admin portal, end users can Filter by “Objective” and “Software Applications” to narrow their search. 
    3. Review the content by searching the relevant topic name in the End User Portal.
  4. Build or customize any Flows that Admins would like to use at launch.  
    1. If Admins had custom Skill Paths in the QuickHelp platform, Admins would have to recreate these skill paths as Flows  
    2. Any custom Flows will also have to be put into a Pack  
  5. Create Groups and assign licenses based on how Admins are targeting their training. This may be one Group if the training is going to everyone or a multitude of Groups for additional targeted goals.  
  6. Prioritize Flows to Groups
    1. If Admins have the “BrainStorm User Engagement Pack” purchased in their Marketplace and do not want end users to receive communications yet, Do Not Prioritize any content to Important or Required until after the BrainStorm platform has been launched.      
  7. Prepare replacement links for any location where Admins have links to the QuickHelp platform to the BrainStorm platform homepage or a specific Flow or Asset. (Template Coming Soon) 
  8. Test end-user experience with the Admin Group.  

Create Awareness Strategy  

  1. Executive Sponsor Launch Email (Internal): Work with the Executive Sponsor to create (or adjust the BrainStorm templatea communication to announce the launch of BrainStorm and the sunset of QuickHelp.  
    1. This should include why it is important to end users, the “What’s in it for me?” and how this change aligns with organizational goals.    
  2. Intranet and Training site (Internal): Prepare a similar announcement on intranet and training sites that notify users of the change, with links to BrainStorm. (Template Coming Soon) 
  3. Newsletter and Viva Engage posts (Internal): These further announce the change, with links to BrainStorm (Template Coming Soon) 
  4. Welcome to BrainStorm” or “Intro to BrainStorm Learning Platform receive” (BrainStorm): One of these two options should be edited to fit the launch and will be scheduled to go out to end users the day after they receive their Executive email.   
  5. Automated Group notifications (BrainStorm): If Admins would like to send the Welcome to BrainStorm email to new users when added to an Automated Group, this can be enabled after the BrainStorm platform has launched.   
  6. Auto Start Flows (BrainStorm): A Flow that starts with a communication can be initiated for a user Group once, and any user that joins the Group after, will have the Flow automatically started for them. The most common types are Tips and Tricks Flows. One should be selected to start sending one to two weeks after launch.   
  7. BrainStorm User Engagement Pack (BrainStorm): If Admins have this pack “Purchased” in the Marketplace on the BrainStorm Admin Portal, any user with content prioritized to them as Important or Required will receive a communication each Tuesday reminding them of the content.   
  8. QuickHelp Events email (BrainStorm): (Template Coming Soon) communicatesPrepare a communication that communicates to end users that if they signed up for QuickHelp events, they will need to sign up for them again on the BrainStorm platform, with a link to the events page.   

Launch BrainStorm and Sunset QuickHelp Checklist  

Prior to Launch

Pull any reports you would like from QuickHelp. After sunset, you will no longer have access to QuickHelp reporting. 

Notify your BrainStrom rep when the Executive Comm will go out and the day you want to sunset QuickHelp (these will typically be the same day). 

Launch Day  

Update priority on content ( to important or required if you have the BrainStorm User Engagement Pack). This should be done first/just before any communications so that any user who logs in, is greeted by applicable content.  

Send Executive Sponsor email. 

Schedule “Welcome to BrainStorm” or “Intro to BrainStorm Learning Platform” for the following day 

Schedule the QuickHelp Events email for 3 days after launch 

Set a reminder to start any Auto Start Flows either 1 or 2 weeks after launch 

Replace links to QuickHelp with the appropriate BrainStorm links 

Post Launch 

Enable the BrainStorm Teams app if not already enabled 

Enable the notify step for Automated Groups. We recommend this be utilized primarily for Onboarding Groups.  

Prepare your next initiatives/campaigns utilizing the same structure. You will want to rotate out content at least once per month, so users have fresh learning materials.  

Follow-up Communication (Internal): Prepare a reminder communication to users from either direct management or something like a Champions Network, two weeks after launch. We recommend one internal communication a month, moving forward. (Template available here) 

Executive Follow-up Communication (Internal): Prepare a communication for one month after the launch date to be sent by your Executive Sponsor as a reminder to users to take advantage of BrainStorm (Template available here ) 


Q: When will end users be informed regarding the migration process? 

A:  End users will not receive any communications from BrainStorm relating to the Migration process until Admins are ready to send out communications. 

Q: Will end users be able to continue to use the QuickHelp platform during the migration process?

A: During the migration process, the QuickHelp platform will continue to run in parallel. 

Q: What are the benefits of migrating from the QuickHelp platform to the BrainStorm platform? 

A: The BrainStorm platform enables Admins to have the flexibility to customize content and Flows that can be structured to meet their end users' needs. The new BrainStorm platform also provides data that helps Admins with decision-making.

Related Articles