Distributor: How to manage Partner Prices?

Introduction

This article is a complete guide for Distributors on how to manage Partner Prices on the Platform. Partner Prices is the central tool for configuring Markup rules that Distributors apply to their Sellers, grouped into Price Tiers and assigned to one or more Organizations. The article covers the Price Tier overview grid, the three tabs available inside every Price Tier (Prices, Organizations, History), how to create new Price Tiers, how to add and remove Organizations, how to configure Markup at different price levels using the side-panel form, the Price Hierarchy rules that determine which configuration wins, and the way changes propagate to existing Subscriptions.

In this article:

• Accessing Partner Prices
• Price Tier overview grid
• Creating a new Price Tier
• Renaming and deleting a Price Tier
• Prices tab
• Creating a new Price rule (Markup configuration)
• Price Hierarchy explained
• Organizations tab
• History tab
• Impact on existing Subscriptions

Accessing Partner Prices

Partner Prices is available at the Distributor level only, and is visible exclusively to users with the Price Tier Admin role. To open it, select Catalog in the top navigation and then Partner Prices from the dropdown.

NOTE! If you do not see the Partner Prices entry, your user does not have the Price Tier Admin role assigned. Contact the Platform Support to request the role.

Price Tier overview grid

The first page of Partner Prices is the Price Tier overview grid. It lists every Price Tier available on the Distributor account, with the Create Price Tier button placed on the left in the primary platform colour.

Grid columns:

• Price Tier — the Price Tier name. Sortable and filterable. Selecting the name opens the Price Tier detail page.
• Organizations — the number of Organizations currently assigned to the Price Tier. The number is displayed in blue and is clickable — selecting it jumps directly to the Organizations tab of the Price Tier.
• Updated By — the user who last modified the Price Tier. Sortable and filterable.
• Updated On — the date the Price Tier was last modified. Sortable.

• Actions — always visible, with two per-row actions:
   

  

  • View Price Tier (eye icon) — opens the Price Tier detail page.
  • Delete Price Tier (trash icon) — removes the Price Tier, with the rules described below.

The grid supports cross-filtering — when a filter is applied on one column, the filter options on other columns are limited to the remaining matching values. Filter and sorting icons appear on mouseover. Horizontal and vertical scroll bars keep the header row sticky while scrolling.

Creating a new Price Tier

To create a new Price Tier, select Create Price Tier at the top left of the overview grid. A side panel opens on the right side of the page.

1. Enter a Name for the new Price Tier.
2. Select Save.

The new Price Tier appears at the top of the overview grid, ready to be opened and configured. At creation time it has zero Organizations assigned and no Markup rules.

Renaming and deleting a Price Tier

Renaming a Price Tier

Open a Price Tier by selecting its name from the overview grid. 

The Price Tier name is shown at the top of the detail page next to a pencil icon. Select the pencil icon, edit the name in the input field, and select Save. Use Cancel to discard the change.

Deleting a Price Tier

From the overview grid, select the trash icon in the Actions column of the row.

 A confirmation pop-up appears with the text:

If every Organization has already been removed from the Price Tier, select Confirm (in primary colour) to delete, or Close / Cancel to keep the Price Tier.
 

Warning! The All (default) Price Tier cannot be deleted — the trash icon is not available for it. Any Organization that ends up without an explicit Price Tier assignment is automatically routed back to the All (default) tier.

Prices tab

The Prices tab is the working area where Markup rules are defined for a Price Tier. The tab opens with a top-level filter banner, a search bar, action buttons, and the grid of existing Markup configurations.

Top-level filters

The banner directly under the tab header shows quick filters. Each shows a count of active and future Markup configurations matching the criterion (effective end date later than today):

• Vendor — Markup rules configured at Vendor level (Price Level = Vendor).
• Offer — Markup rules configured at Offer level (Price Level = Offer).
• Offer Component — Markup rules at Offer Component level (Price Level = Offer Component).
• Seller — Markup rules that target a specific Seller (Seller column value other than All).
• Customer — Markup rules that target a specific Customer (Customer column value other than All).
• All Price Levels — every active and future Markup configuration.

Selecting a filter narrows the grid to the matching rows. Filters can be cleared by selecting All Price Levels.

Search

The Search field accepts free-text input matched against Seller Name, Customer Name, Price Level, Vendor Name, Offer Name, Offer Component Name, Offer ID, Offer Component ID, External Offer Id, and Vendor ID.

Grid columns

The grid lists every Markup configuration in the Price Tier. The following columns are available — the ones marked "default" are visible without any user action; others can be added through Choose columns.

Additional grid behaviour:

• Choose columns — open the column picker to toggle visibility per column.
• Column reordering — columns can be reordered by drag.
• Cross-filtering — when a filter is applied on one column, the options on other columns are limited to the remaining values.
• Sticky header — both horizontal and vertical secondary scroll bars keep the header row visible.
• Filter / sorting icons — only visible on mouseover to keep the header clean.
• Pagination — page selector below the grid, consistent with the modern Subscriptions grid.

Exporting Prices data

Select Export above the grid to open the export menu. Two options are available, matching the Customer Prices behaviour:

• Export All — exports every Markup configuration in the Price Tier.
• Export Current Selection — exports only the rows currently visible in the grid (after filters and search).

Creating a new Price rule

Select Create New above the grid to open the side panel for creating a new Markup configuration. The panel is organised into collapsible sections, all open by default.

Organization

Choose which Sellers and Customers the rule applies to:

• Sellers — dropdown listing the Sellers assigned to the current Price Tier. Default value: All.
• Customers — dropdown listing the Customers belonging to the selected Seller. Default value: All. Only populated after a specific Seller is selected.

Price Level

Choose the granularity of the rule:

• Vendor only — the Markup applies to every Offer from the selected Vendor.
• Vendor + Offer — the Markup applies to a specific Offer.
• Vendor + Offer + Offer Component — the Markup applies to a specific Offer Component within the chosen Offer.

Period

• Date from (required) — effective start date.
• Date till — effective end date. Select To infinity to leave the rule open-ended.

If Date from is left empty when the form is submitted, the field border turns red and the error "Date From is required." appears directly below the input. The form submission is blocked until a valid date is selected; the red border and error message clear automatically.

Price Source

Two radio options determine the basis on which the Markup is applied:

• Cost Price (You Buy For) — the price the Distributor pays the Vendor.
• Retail Price (Suggested Retail Price) — the price recommended by the Vendor.

Pricing Method & Price Calculation

Price Method

Choose how the markup value is interpreted

• Markup (% on cost) — the percentage added to the Cost Price. Helper text: "Markup is the percentage added to cost price".
• Margin (% of selling price) — the percentage of the selling price. Helper text: "Margin is the percentage of selling price".

Enter the percentage value in the input field below the radio buttons. Up to 6 decimal places are supported, matching the precision used in the Customer Prices section.

Price Calculation Preview

A preview box updates live as values change and illustrates how the configuration would behave on a sample price.

Base information:

• Price — sample price; any non-negative number. Default 100.
• Markup or Margin — the value entered above.
• Base Unit Price — calculated as Price × (1 + Markup) for Markup mode, or Price / (1 − Margin) for Margin mode.

Per Unit Profit:

• Profit Amount — difference between the sample Price and the Base Unit Price. For example, with Price = 100 and 5% Markup, this is 5 (105 − 100).
• Profit Margin — the profit expressed as a margin: Profit Amount ÷ Base Unit Price. For the example above, 5 ÷ 105 = 4.761905%.

Conversion between the two modes follows: Margin from Markup = Markup / (1 + Markup), and Markup from Margin = Margin / (1 − Margin).

A disclaimer below the preview reminds users that the calculation is illustrative and does not reflect actual Product prices.

After completing all sections, select Confirm to save the rule, or Cancel to discard.

Price Hierarchy explained

Multiple Markup rules can apply to the same transaction; in that case the Platform picks the most specific one. Select Price Hierarchy Explained above the grid to open the explanation pop-up.

Price Level priority (lowest to highest)

1. All — global default setting.
2. Vendor — applies to all Products from a Vendor.
3. Offer — applies to a specific Product.

Customer / Seller specificity

• A rule for a specific Seller overrides a rule for All Sellers.
• A rule for a specific Customer overrides a rule for All Customers.
• The most specific combination (specific Price Level + specific Seller + specific Customer) wins.

Example from the in-app explainer: in a table where rules from All+5% up to Offer+Seller 1+Customer A+16% are configured, the 16% rule applies for that combination instead of any of the more general ones.

Organizations tab

The Organizations tab lists every Organization currently assigned to the Price Tier. The tab header shows the count in brackets — for example, Organizations (82).

Grid columns

• Status — Organization status with a coloured circle (matching the modern Organizations grid). Sortable and filterable.
• Organization — Organization display name. Sortable.
• External ID — external identifier of the Organization. Sortable.
• Country — Organization country. Sortable and filterable.
• Updated On — date the Organization was assigned to the Price Tier. Sortable.
• Updated By — user who assigned the Organization to the Price Tier. Sortable and filterable.
• Actions — trash icon for removing a single Organization from the tier. Hovering shows the tooltip "Remove an organization".

Cross-filtering, sticky header (horizontal and vertical scroll), and per-page navigation behave the same as in the Prices tab.

Adding Organizations

Select + Add organization (or Add Organizations) next to the search bar.

 A pop-up opens, titled Add organizations to Price Tier.

1. Use the Search field at the top of the pop-up to find Organizations.
2. Tick the checkbox next to each Organization you want to add. The pop-up shows the running count: "N organization(s) selected".
3. Select Confirm to add the selected Organizations in bulk, or Cancel to close without changes.

 

NOTE! If an Organization is already assigned to another Price Tier, a confirmation message is displayed before the reassignment is saved. The current and the new Price Tier are shown greyed out, and the change applies starting from the next calendar day.

Removing Organizations

There are two ways to remove Organizations from a Price Tier:

• Single removal — select the trash icon in the Actions column of the row. A confirmation pop-up appears with the title "Remove organization from Price Tier?" and the buttons Cancel / Confirm (in primary colour).
  
  
• Bulk removal — select Remove organizations next to Add organization. A pop-up titled Remove organizations from Price Tier opens, with the same search and checkbox layout as the add pop-up. Select the Organizations to remove and select Remove selected.
  
  

 

NOTE! When an Organization is removed from a Price Tier without being assigned to another, the Platform automatically reassigns it to the All (default) Price Tier.

History tab

The History tab logs every change made to the Price Tier — including Markup rule creation and edits, Organization assignments, and Price Tier rename actions. It is the same activity history that powers the Distributor-level activity logging.

1. Use the Period selection dropdown to choose 2 Weeks, 1 Month, 3 Months, 6 Months, or Custom.
    

   

2. For Custom, set the From and Till dates using the date pickers.
    

   

3. Select Show results.

   

The grid then lists each change with columns Entity, Name, Action, By User, Organization, Date, and Changes. All columns are sortable; Entity, Name, Action, and By User are filterable.

 

NOTE! The activity history captures all changes from August 2022 until the day before the current date. Same-day changes appear once the next day's history is generated.

Impact on existing Subscriptions

Changes made in Partner Prices do not retroactively change pricing on every existing Subscription. The behaviour depends on the Subscription type:

• License-based and other renewable Subscriptions — the previously configured Markup from the source Price Tier remains in effect until the Subscription's next Renewal date. New Markups from the changed Price Tier assignment apply from the Renewal onwards.
• Usage-based Subscriptions (e.g. Azure Plan) — these Subscriptions do not renew. When the Price Tier assignment for a Reseller is changed, all existing usage-based Subscriptions of that Reseller have the Distributor Markup updated automatically — the change applies starting from the next calendar day.

Summary

Partner Prices centralises Markup management for Distributors into Price Tiers, each containing three working tabs: Prices for the Markup rules, Organizations for the Sellers the tier applies to, and History for the audit log. New Price Tiers are created from the overview grid via the Create Price Tier button; Markup rules are configured through a guided side panel covering Organization, Price Level, Period, Price Source, and Pricing Method & Price Calculation, with a live Price Calculation Preview. The Price Hierarchy Explained pop-up documents how the most specific rule wins. Organizations can be added or removed individually or in bulk, with automatic fallback to the All (default) tier when unassigned. Markup changes apply from the next calendar day for usage-based Subscriptions and from the next Renewal date for renewable Subscriptions; subscription-level Markup always overrides the Price Tier configuration.

Related content

• Seller: Price Hierarchy
• Distributor: Seller Price Import
• How to Change the Price on Existing Subscription