Skip to main content

Table of Contents

Exporting an application, product rule, or ruleset to an archive or repository by using the Export wizard


Only available versions of this content are shown in the dropdown

Export rules from a Pega Platform system into an product rule, archive file, or repository by using the export wizard. An archive is useful for sharing rulesets between instances of Pega Platform.

Do not create an archive when any rule that you want to export is checked out. If a rule is checked out, the original version of the rule is included in the archive, but the checked-out version of the rule is not included. An error message lists the checked-out rules.

When creating an archive file name, consider the following:

  • Use a file name that is valid for both the destination server and the current server.
  • The ".zip" suffix is optional.
  • You cannot include spaces or an equal sign character (=) in the file name.
  1. In the header of Dev Studio, click Configure Application Distribution Export .

  2. Select an export mode to determine the scope of the contents of the .zip file.

    • By Application – Create an archive file that contains all rules and data in an application.
    • By RuleSet/Version – Create an archive file that contains all rules in a ruleset and version (or all versions).
      If you have one or more rulesets that use Application Validation (AV) mode, select only one application to associate with the AV ruleset.
    • By Product – Create an archive file that contains rules and data that are defined by an existing product rule ( Rule-Admin-Product rule type).
    • By Patch – Create an archive file that contains rules and data that are defined by an existing product page rule ( Rule-Admin-Product-Patch rule type).
    • Archive On Server – Download a copy of any archive file that is already in the ServiceExport directory of an application to your workstation or another directory on your local area network. Click a .zip file from the list to download.
      If you have direct access to the file system on your server, you can copy the .zip file using File Transfer Protocol (FTP) rather than using this option.
  3. Click Perform export.

  4. Save the archive to your file system or export it to a repository.

    1. To save the archive to your local file system, click the Download link.

    2. To export the archive to a repository, enter the Repository name and click Export.

  5. To display error messages (if any), click the Total Errors link in the lower right corner of the display form.

Use the Import wizard to import the files to another system.
Did you find this content helpful?

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.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us