Welcome to Zuora Product Documentation

Explore our rich library of product information

Create and manage catalog rules

Use this procedure to create and publish a Catalog Rule, then find and update a rule when its policy changes. Available rule types and actions depend on the rule group and the product experiences enabled for your tenant.

  • Confirm that Catalog Rules is enabled for your tenant and that you have access. Access is managed at the tenant level, not through Billing User Roles. If you cannot open Catalog Rules, contact your Zuora administrator.

  • If Configurable Bundles is enabled for your tenant, Catalog Rules is enabled as well.

  • Ask your administrator to confirm that the Context Schema includes the fields and validated values you need for your conditions. Context Schemas can include standard Zuora fields, approved custom fields, and custom objects.

  • Identify the rule group, rule type, conditions, and outcome you need. For a Configurable Bundle, use only eligibility or packaging rules supported by the bundle workflow.

  1. In Zuora Billing, open Catalog Rules from the Product Catalog area.

    The page shows rule groups and a list of rules. Select a group tile to filter the list.

  2. Select Create Rule.

    The rule builder opens with Overview, Conditions, and Actions. Select a section on the canvas to go directly to it.

  3. In Overview, enter a rule name and select the rule group and rule type. Add a description. Set the effective date range, priority, and mandatory setting when these fields are available for the selected rule type. Use a mandatory rule only when the policy must always be enforced, such as a contractual or compliance requirement. Select Next.
  4. In Conditions, define when the rule applies.
    • Select a context field, operator, and value for each condition. Choose from the fields and values available in the Context Schema.

    • Choose Match All when every condition must be true, or Match Any when at least one condition must be true.

    • Select Condition to add a condition at the current level. Select Group to add a nested condition group with its own Match All or Match Any setting.

    • If you add no conditions, the rule applies in every context in which it is evaluated. Use a condition-free rule only when that broad scope is intended.

    Select Next.

  5. In Actions, select the outcome for the chosen rule type. Depending on the rule group, an action can display or suppress products or plans, include required products, exclude incompatible products, filter choices, or define another supported outcome. Complete the required fields and select Next.

    For Configurable Bundles, applicable eligibility and packaging rules affect product selection in the bundle's Select Products step. Eligibility is evaluated before packaging inclusion and exclusion rules. A product hidden by an eligibility rule is not made available by an inclusion rule.

  6. Test the rule in the simulator with representative context. Confirm that the expected action occurs and that the rule does not apply to a context that should not match. Review the explanation of the result, if available.
  7. When the rule is ready, select Publish.

    A published rule appears as Active in the rules list and is evaluated during its effective date range.

  8. Find and update a rule:
    1. Open Catalog Rules from the Product Catalog area.
    2. To narrow the list, select a rule-group tile. To find a rule by name, enter its name in the search field.
    3. Select the rule name to open it. If the row provides an expand control, select it to review the rule details without opening the editor.
    4. Make the required changes to the overview, conditions, or actions. Review the rule in the simulator with representative context.
    5. Select Publish to make the updated rule effective. Confirm its status and effective dates in the rules list.

The published rule is evaluated by supported product experiences when they receive matching context. The rule returns a decision; the consuming experience acts on that decision. Catalog Rules does not create or modify billing transactions.