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

# SmartPrice AI: automated product pricing for Cartble

> SmartPrice AI analyzes your costs, expenses, and target margin to calculate and apply optimal prices across your entire product catalog automatically.

SmartPrice AI is an analytics plugin built into Cartble that takes the guesswork out of product pricing. Instead of setting prices manually, you define your target profit margin and your cost structure — raw materials, packaging, labor, fixed costs, and transaction fees — and SmartPrice AI calculates the recommended selling price for each product. You can review suggestions individually or apply them in bulk across your catalog.

## Key capabilities

SmartPrice AI gives you a comprehensive set of tools to build and manage your pricing strategy from a single place inside the admin.

<CardGroup cols={2}>
  <Card title="Target Margin Control" icon="percent">
    Set your desired profit margin percentage. SmartPrice AI uses this as the floor for every price recommendation.
  </Card>

  <Card title="Volume-Aware Calculations" icon="chart-line">
    Enter your estimated monthly sales volume so the engine can distribute fixed costs accurately across your products.
  </Card>

  <Card title="Expense Tracking" icon="receipt">
    Log recurring expenses — rent, staff, packaging — as fixed costs. SmartPrice AI factors these into every price calculation.
  </Card>

  <Card title="Transaction Fee Awareness" icon="credit-card">
    Define your payment gateway and marketplace fees so your recommended prices already account for those deductions.
  </Card>

  <Card title="Discount Management" icon="tag">
    Create and manage promotional discounts from within the plugin without affecting your base pricing configuration.
  </Card>

  <Card title="Price Builder" icon="hammer">
    Review AI-calculated prices per product, adjust individually, and apply changes to your live catalog in one action.
  </Card>

  <Card title="Smart Rounding" icon="wand-magic-sparkles">
    Enable Smart Rounding to automatically round recommended prices to the nearest `.90` psychological price point (e.g., $49.90 instead of $50.12), improving perceived value without manual adjustment.
  </Card>
</CardGroup>

## How to enable SmartPrice AI

To activate the plugin, navigate to **Admin → Plugins** and click the **SmartPrice AI** card. If your current plan includes the `enableSmartPrice` capability, you will see an **Enable** toggle. Turn it on and SmartPrice AI will appear as a new section in your admin sidebar.

<Note>
  SmartPrice AI is available on specific Cartble plans. If you do not see it in the Plugins Manager or the Enable toggle is unavailable, visit **Admin → Billing** to review your current plan and upgrade if needed.
</Note>

## Configuration walkthrough

Once SmartPrice AI is enabled, use the following steps to set up your pricing configuration.

<Steps>
  <Step title="Open SmartPrice AI from the admin sidebar">
    After enabling the plugin, a **Smart Price** section appears in your admin sidebar. Click **Home** to see an overview of your current pricing health, then proceed to the individual configuration pages.
  </Step>

  <Step title="Set your target margin">
    Go to **Smart Price → Price Builder** and enter your target margin percentage — for example, `40` for a 40% profit margin. This value is used as the baseline for all price calculations.
  </Step>

  <Step title="Enter your estimated monthly sales volume">
    Still in Price Builder, enter how many units you expect to sell per month. SmartPrice AI divides your fixed costs by this number to determine the per-unit cost burden, which keeps your per-product prices accurate at scale.
  </Step>

  <Step title="Enable Smart Rounding (optional)">
    In Price Builder, toggle **Smart Rounding** on if you want recommended prices automatically adjusted to a `.90` psychological price point (for example, $49.90 instead of $50.13). This setting applies to all price recommendations across your catalog.
  </Step>

  <Step title="Add your recurring expenses">
    Navigate to **Smart Price → Fixed Costs** and add your ongoing expenses such as rent, staff wages, and packaging materials. Each expense entry reduces the net margin available per product and is reflected in updated price recommendations.
  </Step>

  <Step title="Configure transaction fees">
    Go to **Smart Price → Transaction Fees** and enter the fee rates charged by your payment gateway or marketplace. SmartPrice AI deducts these percentages from the final price calculation so your target margin is preserved after fees.
  </Step>

  <Step title="Review and apply recommended prices">
    Return to **Smart Price → Price Builder** to see the AI-calculated recommended price for each product based on your full cost structure. Review prices individually, make any adjustments, and click **Apply** to update your live product catalog.
  </Step>
</Steps>

## SmartPrice AI admin pages

The plugin adds the following pages to your admin sidebar under the **Smart Price** section:

| Page               | Purpose                                                           |
| ------------------ | ----------------------------------------------------------------- |
| Home               | Overview dashboard of your pricing health and recent changes      |
| Price Builder      | Per-product pricing recommendations based on your full cost model |
| Discounts          | Create and manage promotional discounts                           |
| Fixed Costs        | Log recurring expenses like rent, staff, and utilities            |
| Pricing Categories | Group products into pricing tiers or strategies                   |
| Transaction Fees   | Define payment gateway and marketplace fee rates                  |
| Packaging          | Track packaging material costs per product                        |
| Marketing Calendar | Schedule pricing changes around promotional events                |

<Tip>
  Update your Fixed Costs and Transaction Fees regularly — especially after renewing supplier contracts or changing payment providers. Stale expense data leads to underpriced products and eroded margins.
</Tip>