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

# Pricing and Installment Calculator

> Configure pricing, currencies, and installment calculator for your projects

Configure pricing settings and enable installment calculations to help customers understand payment options for your apartments.

## Currency Configuration

### Setting Project Currency

<Steps>
  <Step title="Open Project Settings">
    Navigate to your project editor and go to Settings.
  </Step>

  <Step title="Select Currency">
    Choose the currency for your project:

    * USD (US Dollar)
    * EUR (Euro)
    * GEL (Georgian Lari)
    * RUB (Russian Ruble)
    * And more supported currencies
  </Step>

  <Step title="Apply Currency">
    Currency is applied to all prices in the project.
  </Step>
</Steps>

### Currency Display

Configure how prices are displayed:

* **Symbol Position**: Before or after price (€100 or 100€)
* **Decimal Places**: Number of decimal places (0, 2, etc.)
* **Thousands Separator**: Comma, period, or space
* **Currency Format**: Custom formatting options

## Apartment Pricing

### Setting Prices

<Steps>
  <Step title="Select Apartment">
    Choose the apartment you want to price.
  </Step>

  <Step title="Enter Price">
    Enter the total price in your project's currency.
  </Step>

  <Step title="Set Price Per Square Meter">
    Optionally set price per square meter (auto-calculated or manual).
  </Step>

  <Step title="Apply Discount (Optional)">
    Set discount percentage or fixed amount if applicable.
  </Step>

  <Step title="Save Price">
    Price is saved and displayed in the widget.
  </Step>
</Steps>

### Price Ranges

Define price categories for filtering:

* **Budget**: Lower price range
* **Standard**: Mid-range prices
* **Premium**: Higher price range
* **Luxury**: Highest price range

## Installment Calculator

### Enabling Installment Calculator

<Steps>
  <Step title="Go to Installment Settings">
    Navigate to Project Settings → Installment Calculator.
  </Step>

  <Step title="Enable Calculator">
    Toggle "Enable Installment Calculator" to ON.
  </Step>

  <Step title="Configure Settings">
    Set calculator parameters (see configuration below).
  </Step>

  <Step title="Test Calculator">
    Use preview to test installment calculations.
  </Step>
</Steps>

### Calculator Configuration

Configure installment options:

<CardGroup cols={2}>
  <Card title="Down Payment">
    * Minimum down payment percentage (default: 20%)
    * Maximum down payment percentage
    * Default down payment amount
  </Card>

  <Card title="Installment Period">
    * Minimum months (default: 6)
    * Maximum months (default: 24)
    * Default period
    * Step increment
  </Card>
</CardGroup>

### Interest Rate (Optional)

If applicable, configure interest:

* **Interest Rate**: Annual interest percentage
* **Calculation Method**: Simple or compound interest
* **Payment Frequency**: Monthly, quarterly, etc.

## Price Display Options

### Price Formatting

Customize price display:

```javascript theme={null}
// Example formats:
"$100,000"      // With symbol and separator
"100 000 USD"   // With space separator
"€100.000"      // European format
"100,000.00"    // With decimals
```

### Price Per Square Meter

Display price per square meter:

<Steps>
  <Step title="Enable Price Per m²">
    Toggle "Show Price Per Square Meter" in display settings.
  </Step>

  <Step title="Configure Display">
    Set display format:

    * Show alongside total price
    * Show in apartment details
    * Calculate automatically
  </Step>
</Steps>

## Discounts and Promotions

### Setting Discounts

<Steps>
  <Step title="Select Apartment">
    Choose apartment for discount.
  </Step>

  <Step title="Set Discount Type">
    Choose:

    * Percentage discount (e.g., 10%)
    * Fixed amount discount (e.g., \$10,000)
  </Step>

  <Step title="Set Discount Period">
    Configure:

    * Start date
    * End date
    * Conditions (if any)
  </Step>

  <Step title="Display Discount">
    Discount is shown with original price and discounted price.
  </Step>
</Steps>

### Promotional Pricing

Create special pricing offers:

* **Early Bird Discounts**: Discounts for early buyers
* **Seasonal Promotions**: Limited-time offers
* **Bulk Discounts**: Discounts for multiple purchases
* **Referral Discounts**: Discounts for referrals

## Currency Conversion

### Multi-Currency Support

<Note>
  Gridix supports displaying prices in multiple currencies. Customers can switch currencies in the widget.
</Note>

Supported currencies include:

* USD, EUR, GBP
* GEL, RUB, TRY
* AED, SAR (for Middle East markets)
* And more

### Currency Toggle

Enable currency switcher in widget:

* **Default Currency**: Set project currency
* **Available Currencies**: Choose which currencies to show
* **Exchange Rates**: Configure exchange rates (manual or API)
* **Auto-Update**: Enable automatic rate updates

## Price Calculations

### Automatic Calculations

Gridix can automatically calculate:

* **Price Per Square Meter**: Total price ÷ Area
* **Monthly Payment**: Installment calculator
* **Total with Interest**: If interest is configured
* **Discount Amount**: Discount calculations

### Manual Override

You can manually override any calculated values:

* Set custom price per m²
* Override installment calculations
* Set custom discount amounts

## Exporting Price Data

<Steps>
  <Step title="Select Export Option">
    Go to Projects → Export → Price Data.
  </Step>

  <Step title="Choose Format">
    Select export format:

    * Excel with formulas
    * CSV for import
    * JSON for APIs
  </Step>

  <Step title="Select Data">
    Choose what to export:

    * Apartment prices
    * Installment schedules
    * Price history
    * Discounts
  </Step>

  <Step title="Download">
    Export file is generated and downloaded.
  </Step>
</Steps>

## Best Practices

<Tip>
  **Consistent Pricing**: Keep prices consistent across all platforms and materials.
</Tip>

<Tip>
  **Clear Display**: Make prices easy to read and understand for customers.
</Tip>

<Tip>
  **Regular Updates**: Update prices regularly to reflect current market conditions.
</Tip>

<Tip>
  **Transparent Calculations**: Show calculation breakdowns in installment calculator for transparency.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Price not displaying correctly">
    * Check currency settings
    * Verify price format configuration
    * Ensure currency is set for project
    * Clear browser cache
  </Accordion>

  <Accordion title="Installment calculator not working">
    * Verify calculator is enabled
    * Check configuration settings
    * Ensure valid price is set
    * Test with different values
  </Accordion>

  <Accordion title="Currency conversion incorrect">
    * Verify exchange rates are up to date
    * Check currency conversion settings
    * Update exchange rates manually if needed
    * Contact support for API issues
  </Accordion>
</AccordionGroup>

## Next Steps

* **[Apartment Management](/en/projects/apartments)** - Set prices for individual apartments
* **[Project Editing](/en/projects/editing)** - Learn about other project settings
* **[Widget Embedding](/en/widgets/embedding)** - See pricing in your embedded widget