Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Navigation rules -

Updated on April 5, 2022

  1. About Navigation rules
  2. Navigation rules -
  3. Editor
  4. Navigation form - Completing the Pages & Classes tab

Records can be created in various ways. You can add a new record to your application or copy an existing one. You can specialize existing rules by creating a copy in a specific ruleset, against a different class or (in some cases) with a set of circumstance definitions. You can copy data instances but they do not support specialization because they are not versioned.

Create a new Navigation rule by selecting Navigation from the User Interface category.

Key parts:

A Navigation rule has three key parts:

Apply to Select the class to which this Navigation rule applies.
IdentifierChoose a unique name that indicates the purpose of the rule. Begin the name with a letter and use only letters, numbers, and a hyphen.
TypeThe Type field appears if your RuleSet list contains the Pega-Mobile ruleset. The type is used as an indicator for display of fields specific to mobile devices. If your application will be accessed by standard and mobile devices, create a navigation rule for each and specify the correct navigation rule in the appropriate portal. Select:

  • Standard if this navigation rule is being developed for applications running non-mobile devices.
  • Mobile if this navigation rule is being developed for mobile devices such, as smartphones or tablets. Rules of Mobile type display Navigation (Mobile) in the rule header.

Rule resolution

When searching for instances of this rule type, the system uses full rule resolution which:

  • Filters candidate rules based on a requestor's ruleset list of rulesets and versions
  • Searches through ancestor classes in the class hierarchy for candidates when no matching rule is found in the starting class
  • Finds circumstance-qualified rules that override base rules
  • Finds time-qualified rules that override base rules

  • About Navigation rules

    Use a Navigation rule to construct a multi-level XML document to be used in navigation and context menus.

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

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