> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kelviq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Promotions

> Boost global sales with purchasing power parity and country-specific discounts

Promotions let you offer location-based discounts to customers around the world — automatically. Set up purchasing power parity (PPP) pricing, enforce security rules to prevent abuse, and render a customizable banner or discounted prices on your storefront — all from the Kelviq dashboard.

Setup takes less than 5 minutes and works with your existing product catalog.

<CardGroup cols={2}>
  <Card title="PPP group discounts" icon="globe">
    Apply discount percentages to economic tier groups — countries with similar purchasing power are grouped automatically. Override any group with a country-specific discount when you need finer control.
  </Card>

  <Card title="Show custom price on website" icon="tag">
    Display the discounted price directly on your pricing page using the Promotions UI SDK. Supports formatted prices, granular price components, and original vs. discounted price comparison.
  </Card>

  <Card title="Security enforcement" icon="shield">
    Block VPNs, proxies, Tor users, and crawlers from claiming localized discounts they're not entitled to. Enforced automatically at checkout.
  </Card>

  <Card title="Promotions UI banner" icon="layout">
    Render a fully customizable banner on your site that shows customers their local discount. Available as an HTML snippet, React component, or via the API.
  </Card>
</CardGroup>

## How it works

1. **Create a promotion** — give it a name, pick which products and plans it applies to, and configure discounts.
2. **Integrate** — add the Kelviq SDK snippet or React component to your frontend. The banner renders automatically for eligible visitors.
3. **Customize** — adjust the banner's appearance (colors, font, placement, close icon) to match your brand.

## Next steps

<CardGroup cols={2}>
  <Card title="Create a promotion" href="/promotions/create-a-promotion">
    Step-by-step guide to setting up PPP discounts, country overrides, and security rules.
  </Card>

  <Card title="Integrate the Promotions UI" href="/promotions/integrate">
    Add the banner to your site using HTML/JS, React, or the Direct API.
  </Card>

  <Card title="Customize the banner" href="/promotions/customize-banner">
    Change colors, font, placement, and more to match your brand.
  </Card>
</CardGroup>