Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cartble.com/llms.txt

Use this file to discover all available pages before exploring further.

Smart Price is Cartble’s built-in pricing intelligence plugin. It calculates suggested prices for every product by combining your cost of goods, fixed business expenses, packaging materials, and payment processing fees — then applies your target profit margin to produce a recommended price you can push to your store with one click. Beyond pricing suggestions, Smart Price tracks inventory health, revenue concentration, and net profit on its dashboard, and it surfaces a markup column directly in your product table so you can spot underpriced items at a glance. Once installed, Smart Price adds eight sections to your admin sidebar under the Smart Price group.
The Home dashboard gives you a real-time overview of your store’s financial performance. It shows four key metrics — total revenue, total costs, net profit, and inventory value — alongside a goal progress bar that tracks how close your revenue is to covering all costs (your breakeven point).The dashboard also displays a revenue concentration chart ranking your top five products by revenue, and an inventory health panel that flags any products with ten or fewer units in stock so you can restock before running out.Use the Home dashboard to get a quick read on whether your pricing is generating profit or leaving you at breakeven, and to identify which products drive the most revenue.
Price Builder is the core pricing tool in Smart Price. It lists all your products with a full cost breakdown for each one: base cost, direct costs (packaging and materials assigned per product), allocated fixed costs, total cost, transaction fees, current price, and current margin.For each product, Smart Price calculates a suggested price that achieves your target profit margin after all costs and fees. You can configure three global settings at the top of the page:
  • Target margin — the profit percentage you want to achieve on each sale
  • Estimated monthly volume — your expected total monthly unit sales, used to allocate fixed costs across products
  • Smart rounding — when enabled, suggested prices are rounded to psychological price points (e.g. ending in .90)
Once you’re satisfied with a suggested price, click the apply button on that row. A confirmation modal shows you the price change before it’s pushed to your store.You can filter and search products by name or category to focus on a specific segment of your catalog.
The Discounts section lets you simulate price reductions and understand their impact on your margins before applying them. For each product you can set a discount as either a percentage or a fixed amount, and Smart Price immediately shows you the discounted price, new margin, new profit per unit, and the sales lift multiplier — the number of additional units you’d need to sell to match the original profit.The section also shows a campaign summary with three aggregate metrics: total margin invested in discounts, projected revenue target, and projected total profit.You have two ways to act on a discount:
  • Schedule — opens a form to create a timed discount with start and end dates
  • Push now — applies the discounted price to your store immediately and logs it as an active discount
A Marketing Assistant at the top of the page suggests upcoming marketing events (such as seasonal sales) and can auto-populate discount values across relevant products with a single click.
Pushing a discount immediately changes the live price of your product. Review the confirmation modal carefully before confirming.
Fixed Costs tracks your recurring business expenses — costs that exist regardless of how many products you sell, such as internet service, e-commerce platform fees, apps, and taxes. Smart Price allocates these costs across your products based on your estimated monthly sales volume, so the Price Builder can factor them into each product’s suggested price.You can add, edit, and delete expense entries. Each entry has a name, amount, category, and month. The page includes a summary of total monthly fixed costs and a filterable list so you can view expenses by month or category.Default categories are created automatically when you first open this section and include: Internet & Telecom, E-commerce Platform, Apps & Plugins, Taxes, Prints, Packaging, Label, and Gift.
Pricing Categories lets you create and organize the cost categories used throughout Smart Price. Categories are tagged with one of three types:
  • Fixed cost — recurring business overhead (used in Fixed Costs)
  • Direct cost — per-unit costs tied to specific products (used in Packaging)
  • Packaging — packaging-specific direct costs
You can add custom categories to match your business structure. Categories are used to classify fixed cost entries and packaging materials, keeping your cost data organized. You can filter the category list by type to view only the categories relevant to a specific section.
Transaction Fees is where you configure the payment processing fees that Smart Price deducts when calculating suggested prices. Each fee entry has a name, a percentage fee, a flat fee (e.g. a fixed amount per transaction), an optional minimum fee, an optional maximum fee, and an active/inactive status.Only active fees are included in price calculations. This lets you add multiple payment processors and toggle them without deleting your configuration.Smart Price combines all active fees into a total transaction fee for each product, which appears as its own column in Price Builder and Discounts.
The Packaging section tracks the physical materials you use to package your products — boxes, bags, labels, tissue paper, and so on. Each material entry includes a name, unit cost, and a category (drawn from your direct cost categories in Pricing Categories).In Price Builder, you can assign packaging materials to individual products using the direct cost selector. Smart Price adds those material costs to the product’s total cost, ensuring your suggested price covers packaging expenses.Adding accurate packaging costs is especially important for physical product stores where packaging represents a meaningful per-unit cost.
The Marketing Calendar shows a monthly calendar view that overlays two types of events:
  • Marketing opportunities — pre-loaded seasonal and commercial events (such as Black Friday or Valentine’s Day) shown in blue. Clicking one takes you to the Discounts section with a discount campaign pre-populated for relevant products.
  • Your discount campaigns — active discounts appear in green; scheduled discounts appear in gray. Discount blocks span the full date range of the campaign.
Use the calendar to plan promotions in advance, identify upcoming selling opportunities, and see at a glance which periods already have active pricing campaigns running.

​
Product table and detail page integrations

In addition to the sidebar sections, Smart Price injects two pieces of UI into your main product management area:
  • Markup column — a column added to the product table that shows the markup for each product, so you can identify underpriced items without leaving the product list
  • Pricing insights panel — a panel on the individual product detail page that surfaces Smart Price analysis for that specific product
Start by entering your fixed costs and packaging materials before using Price Builder. Smart Price’s suggested prices are only as accurate as the cost data you provide.