Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

Agent Custom Settings

Custom Settings allow an Agent to have different Commission details apply other than the standard Commission Rates or default Agent values.

Custom Settings allow an Agent or Organization to have commission behavior that differs from the default values defined in Agent Details or standard Commission Rates. Custom Settings apply on an exception basis and are configured by Issuer and Product Type.

Custom Settings can be created manually from the Agent Details page or created through an import.

Custom Settings Add page.

Purpose of Custom Settings

Custom Settings are used to override default Agent values for the following commission attributes:

    • Advance Months
    • As Earned
    • Alternate Contract
    • Alternate Upline

Multiple Custom Settings may exist for an Agent if they do not share the same Issuer and Product Type combination.

Creating a Custom Setting

Custom Settings are created from the Custom Settings tab within Agent Details.

To create a Custom Setting:

    • Select values for Issuer and Product Type
    • Enter one or more override values as needed
    • Select Add to save the setting

Custom Settings – multiple settings displayed

The Custom Settings entry form includes the following fields:

    • Issuer: Select a specific Issuer or Any
    • Product Type: Select a specific Product Type or Any
    • Advance Months: Enter the number of advance months to apply
    • As Earned: Checkbox to indicate commissions should be paid as earned
    • Alternate Contract: Select an alternate Contract to use for commission rates
    • Alternate Upline: Select an alternate Agent to use for hierarchy calculation

Issuer and Product Type Selection

Selecting Any for Issuer or Product Type means the setting applies to all Issuers or Product Types.

Validations exist to prevent conflicting Custom Settings:

    • If a Custom Setting exists for Any Issuer, another setting cannot be created for a specific Issuer that would contradict it
    • If a Custom Setting exists for Any Product Type, another setting cannot be created for a specific Product Type that would contradict it

This behavior differs from Commission Rates, where Any means “unless otherwise specified.” Refer to the Commission Rates section for additional details.

Viewing Existing Custom Settings

Existing Custom Settings are displayed in a grid on the Custom Settings page.

The grid displays:

    • Issuer
    • Product Type(s)
    • Advance Months
    • As Earned indicator
    • Alternate Contract
    • Alternate Upline

Each row represents a single Custom Setting and can be reviewed or removed as needed.

Advance Months

The Advance Months Custom Setting controls how many months of advance commission are paid, subject to constraints.

If advance months are determined by a Pay Code:

    • The Custom Setting cannot increase the advance beyond the Pay Code value
    • For example, if the Pay Code allows 3 months and the Custom Setting specifies 6 months, only 3 months will be advanced

If advance months are determined by Commission Rates:

    • A Custom Setting may allow more months than the Commission Rate
    • For example, if Commission Rates specify 6 months and a Default Pay Code is used, a Custom Setting of 9 months will result in 9 months of advances

More commonly, Advance Months are used to limit advances, such as reducing Issuer averages from 6 months down to 3 months at the Agent’s request.

As Earned

The As Earned option may be controlled globally or by exception.

When As Earned is checked in Agent Details:

    • Custom Settings may be created to allow advances for specific Issuer and/or Product Type combinations

When As Earned is not checked in Agent Details:

    • Custom Settings may be used to apply As Earned behavior for specific Issuer and/or Product Type combinations

A Custom Setting with As Earned checked cannot be created for Any Issuer and Any Product Type. In that scenario, the As Earned checkbox in Agent Details must be used instead.

Termination Considerations

When an Agent is terminated, it is common to set the Agent to As Earned.

In these cases, the admin should:

    • Review all existing Custom Settings
    • Remove any Custom Settings that still allow advances

This ensures advances are not incorrectly paid after termination.

Alternate Contract

An Alternate Contract Custom Setting allows an Agent to be paid using Commission Rates from a Contract other than the default Contract in Agent Details.

When an Alternate Contract is applied:

    • Commission Rates are pulled from the alternate Contract
    • The Commission Results page displays the Alternate Contract
    • Commission Distributions on the Policy reflect the Alternate Contract and associated rates

Alternate Upline

The Alternate Upline Custom Setting overrides the normal hierarchy used for commission calculations.

For example:

    • Agent D normally reports to Agent C, then Agent B, then Agent A
    • If an Alternate Upline of Agent B is specified:
      • Commissions are generated for Agent D, Agent B, and Agent A
      • Agent C is excluded from the hierarchy for that Issuer or Product Type

The system enforces a validation preventing an Agent from selecting themselves as an Alternate Upline in a Custom Setting.

This differs from Agent Details, where selecting self as Upline designates the Agent as top‑level.

Additional Notes

    • Custom Settings may be created manually or via the Agent Custom Settings import
    • An Agent Custom Settings Report is available for auditing and review
    • Validations prevent overlapping or contradictory Issuer and Product Type combinations