Skip to main content


Migrating Next-Best-Action Designer from version 1 to version 2

Suggest edit Updated on November 16, 2021

When planning the migration, consider the various environments that you may have in your pipeline. First do the migration in a single environment, in a dedicated, unlocked upgrade ruleset version, and then migrate all the rule changes to other environments in the pipeline.

To migrate the Next-Best-Action Designer:
  1. Suspend any outbound schedules defined for the existing Next-Best-Action configuration defined in Next-Best-Action Designer version 1.
  2. Ensure that all Pega Customer Decision Hub assets are checked in.
  3. Ensure that the ruleset and version used by your access group are unlocked, or create an unlocked version of the ruleset. By default, the ruleset used to store the configuration is Artifacts.
  4. Ensure that the ruleset and version used by your Context Dictionary is unlocked. You can check the ruleset and version on the SettingsContext Dictionary landing page in App Studio.
  5. In Dev Studio, click RecordsSysAdminDynamic System Settings.
  6. Click Create.
  7. Fill out the following information:
    • Short description: optionally, enter the description of this Dynamic System Setting, for example, Enables the upgrade of Next-Best-Action Designer to version 2.
    • Owning Ruleset: enter PegaMKT-Engine.
    • Setting Purpose: enter MKTEnableNBADversion2Upgrade.
  8. Click Create and open.
  9. Set the value of the setting to true.
  10. Click Save.
  11. Log off from Pega Customer Decision Hub and then log back in.
  12. In App Studio or in the Pega Customer Decision Hub portal, click Next-Best-ActionDesigner. The Next-Best-Action Designer now shows the option to upgrade to version 2.
  13. Click Migrate now. The configuration of Next-Best-Action and its strategy framework is upgraded.
  14. If you do not plan to implement action treatments, introduced in Pega Marketing 8.2, deactivate Next-Best-Action treatment processing. This ensures that offers created before the upgrade function correctly. After you associate your offers with treatments, you can enable treatment processing again. For more information, see Treatments and channels.
    1. Click the gear icon in the upper right corner of the Next-Best-Action Designer.
    2. Set the Channel treatment processing toggle to OFF.
    3. Click Submit.
What to do next: After migrating Next-Best-Action Designer, review and test the migrated strategies to ensure that they work with the new configuration.
Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us