pricing

Design Crystallize pricing using price variants, price lists, and promotions.

4|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/CrystallizeAPI/ai --skill pricing-crystallizeapi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pricing
Source: https://github.com/CrystallizeAPI/ai/tree/main/use-crystallize/skills/pricing
Command: npx skills add https://github.com/CrystallizeAPI/ai --skill pricing-crystallizeapi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you design and implement correct, maintainable pricing strategies in Crystallize so customers see the right currency, price type, and discounts at checkout.

Core Features & Use Cases

  • Pricing hierarchy design: Plan how Price Variants, Price Lists, and Promotions work together and resolve in the correct priority order.
  • Variant strategy for complex stores: Choose pricing variant patterns for retail vs sales (was/now), B2B vs B2C, multi-currency, and membership tiers.
  • Market, price list, and promotion architecture: Set up multi-market segmentation and define when to use Price Lists (persistent context) versus Promotions (cart-level campaigns).
  • Operational guidance: Avoid common mistakes (like exploding variant counts or using promotions for permanent differences) and choose a migration path as pricing needs grow.

Quick Start

Ask the skill to recommend a minimal pricing setup for your business based on whether you need multi-currency, was/now sale pricing, B2B tiers, and any time-limited campaigns.

Frequently Asked Questions about pricing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up multi-currency pricing across different markets?

Multi-currency pricing requires configuring distinct price variants and price lists for each market. You assign currency-appropriate identifiers to variants, then map those variants to market-specific price lists to ensure customers see correct localized pricing.

What is the difference between using price lists and promotions for campaign pricing?

Price lists handle persistent pricing contexts like B2B wholesale tiers or customer-group agreements, while promotions manage time-limited cart-level campaigns. Using promotions for permanent price differences is a common mistake that complicates maintenance.

How do I implement was/now sale pricing without exploding variant counts?

Was/now retail pricing should use price variants rather than creating separate product variants. You define a standard price variant and a sale price variant within your price lists, avoiding variant count explosion while displaying original and discounted prices.

Can I apply buy-x-get-y and coupon discounts at the cart level?

Buy-x-get-y mechanics and coupon discounts are applied through the promotions layer. Promotions resolve at the cart level after price variants and price lists, enabling time-limited campaign discounts without altering persistent product pricing.

When should I use B2B wholesale tiers versus B2C retail pricing in my store?

B2B wholesale tiers and B2C retail pricing use separate price lists to serve different customer contexts. Price lists let you assign persistent tier-based pricing to specific customer groups, while variants handle the display differences between B2B and B2C catalogs.

Why does my promotion override not work with customer-group price lists?

Promotions and price lists follow a strict variant-to-price-list-to-promotion resolution hierarchy. If a customer-group price list already sets a persistent price, the promotion must be configured to resolve correctly within that hierarchy rather than replacing it entirely.