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

# Dashboard & KPIs Guide

> Learn how to use the Steer Autos Dashboard and manage your Key Performance Indicators

## Introduction

The Steer Autos Dashboard is your command center for monitoring and managing your automotive business operations. With customizable KPIs, interactive charts, and real-time data visualization, you can make data-driven decisions quickly and efficiently.

<Note>
  💡 **Pro Tip** - The dashboard automatically adapts to your language and region, displaying currency symbols and number formats according to your selected country.
</Note>

## Dashboard Overview

### Main Components

The dashboard consists of several key sections:

<CardGroup cols={2}>
  <Card title="KPI Cards" icon="chart-simple">
    Customizable metric cards displaying your most important business indicators with trend information and period comparisons.
  </Card>

  <Card title="KPI Charts" icon="chart-line">
    Visual representations of your KPI data over time, helping you identify patterns and trends at a glance.
  </Card>

  <Card title="Recent Cars" icon="car">
    Quick access to your latest vehicle additions with filtering options by size (small, medium, large).
  </Card>

  <Card title="Statistics Carousel" icon="sliders">
    Rotating display of key statistics and performance metrics for easy monitoring.
  </Card>
</CardGroup>

## Working with KPIs

### Viewing KPIs

KPIs are displayed as interactive cards on your dashboard, showing:

* **Current Value**: The metric's latest value
* **Trend Indicator**: Visual representation of increase/decrease
* **Period Comparison**: "Since last week" or "Since last month"
* **Chart Visualization**: Optional graphical representation (if enabled)

### KPI Categories

KPIs are organized into five main categories for easy filtering:

<Tabs>
  <Tab title="Inventory">
    Track vehicle stock levels, turnover rates, and inventory age.

    **Key Metrics:**

    * Average Age of Inventory
    * Inventory Turnover Ratio
    * Cars Added Per Day
  </Tab>

  <Tab title="Sales">
    Monitor sales performance, pricing, and profitability.

    **Key Metrics:**

    * Average Selling Price
    * Average Days to Sell
    * Gross Profit Margin
  </Tab>

  <Tab title="Operations">
    Oversee operational efficiency and costs.

    **Key Metrics:**

    * Total Repair Cost
    * Total Damage Cost
    * Sum of Fix Costs
  </Tab>

  <Tab title="Customer">
    Measure customer satisfaction and retention.

    **Key Metrics:**

    * Customer Satisfaction Score
    * Customer Retention Rate
  </Tab>

  <Tab title="Marketing">
    Evaluate marketing effectiveness and ROI.

    **Key Metrics:**

    * Lead Generation
    * Campaign Performance
  </Tab>
</Tabs>

### Managing KPI Settings

To customize your KPIs, click the **Settings** icon on your dashboard.

<Steps>
  <Step title="Open KPI Settings">
    Click the gear icon in the top-right corner of your dashboard to open the KPI Settings modal.
  </Step>

  <Step title="Search and Filter">
    Use the search bar to find specific KPIs, or use the category filter to browse by type (All, Inventory, Sales, Marketing, Operations, Customer).
  </Step>

  <Step title="Toggle Visibility">
    Click the eye icon next to any KPI to show or hide it from your dashboard. Hidden KPIs won't appear on your main view but can be re-enabled at any time.
  </Step>

  <Step title="Reorder KPIs">
    Click "Enable Reorder" to drag and drop KPIs into your preferred order. This affects how they appear on your dashboard.
  </Step>
</Steps>

### Creating Custom KPIs

<Warning>
  Custom KPI creation is available for Admin users only. Contact your system administrator if you need custom metrics.
</Warning>

Custom KPIs allow you to track business-specific metrics:

<Steps>
  <Step title="Add Custom KPI">
    Click the **"Add Custom KPI"** button in the KPI Settings modal.
  </Step>

  <Step title="Configure Basic Information">
    **Title**: Enter a descriptive name for your KPI

    **Description**: Provide context about what this metric measures

    **Key**: Create a unique identifier (e.g., `customRevenue`)

    **Category**: Select the appropriate category (Inventory, Sales, etc.)
  </Step>

  <Step title="Set Appearance">
    **Icon**: Choose from available icons to represent your KPI

    **Color**: Select a color theme (Blue, Emerald, Yellow, Orange, Green, Purple, Pink, Indigo, Red, Cyan)
  </Step>

  <Step title="Configure Data">
    **Data Type**: Choose between Number, Currency, or Percentage

    **Aggregation**: Select how to calculate the metric (Sum, Average, Count, Min, Max)

    **Target Model**: Specify the data source (e.g., Car, Sale)

    **Target Field**: Select the field to aggregate
  </Step>

  <Step title="Enable Charts (Optional)">
    Toggle **"Enable Chart"** to add visualization

    Choose chart type: Donut, Bar, Line, Area, or Radial

    Configure display options (Show Legend, Show Labels, etc.)
  </Step>
</Steps>

## KPI Charts

### Viewing Charts

Charts provide visual insights into your KPI trends over time. To view charts:

1. Charts are displayed in the **"KPI Charts"** section below your KPI cards
2. Each chart shows historical data for KPIs where visualization is enabled
3. Hover over chart elements to see detailed values

### Chart Types

<AccordionGroup>
  <Accordion icon="chart-pie" title="Donut Chart">
    **Best For:** Showing proportions and percentages

    * Displays data as segments of a circle
    * Perfect for category breakdowns
    * Easy to understand at a glance
  </Accordion>

  <Accordion icon="chart-bar" title="Bar Chart">
    **Best For:** Comparing values across categories

    * Horizontal or vertical bars
    * Great for rankings and comparisons
    * Supports multiple data series
  </Accordion>

  <Accordion icon="chart-line" title="Line Chart">
    **Best For:** Showing trends over time

    * Connects data points with lines
    * Ideal for temporal data
    * Reveals patterns and fluctuations
  </Accordion>

  <Accordion icon="chart-area" title="Area Chart">
    **Best For:** Emphasizing magnitude over time

    * Similar to line chart with filled area
    * Shows cumulative totals
    * Highlights volume changes
  </Accordion>

  <Accordion icon="chart-simple" title="Radial Chart">
    **Best For:** Circular progress visualization

    * Circular progress indicator
    * Perfect for goals and targets
    * Compact and visually appealing
  </Accordion>
</AccordionGroup>

## Reordering Dashboard Elements

You can customize the layout of your dashboard to prioritize the information most important to you.

### Reorder Mode

<Steps>
  <Step title="Enable Reorder Mode">
    Click the **"Drag to reorder"** button at the top of your dashboard.
  </Step>

  <Step title="Drag and Drop">
    Click and hold on any KPI card, then drag it to your desired position. Other cards will automatically adjust.
  </Step>

  <Step title="Save Layout">
    Click **"Done"** to save your new layout. Your preferences are automatically saved and will persist across sessions.
  </Step>
</Steps>

<Tip>
  You can also resize certain dashboard widgets by dragging their corners when in reorder mode.
</Tip>

## Recent Cars Section

The Recent Cars table shows your latest vehicle additions with quick actions.

### Features

* **Size Filter**: Filter cars by size (Small, Medium, Large) using the dropdown selector
* **Status Badges**: Visual indicators showing car status (Loading, Inspected, Sold)
* **Quick Actions**:
  * 👁️ **View**: Preview car details
  * ✏️ **Edit**: Modify car information
  * 🗑️ **Delete**: Remove car from inventory

### Filtering by Size

Click the size selector dropdown and choose:

* **Small**: Compact and subcompact vehicles
* **Medium**: Sedans and mid-size vehicles
* **Large**: SUVs, trucks, and large vehicles

## Multi-Language & Currency Support

The dashboard automatically adapts to your selected country and language:

### Supported Languages

<CardGroup cols={3}>
  <Card title="🇬🇧 English" />

  <Card title="🇫🇷 French" />

  <Card title="🇪🇸 Spanish" />

  <Card title="🇩🇪 German" />

  <Card title="🇮🇹 Italian" />

  <Card title="🇵🇹 Portuguese" />

  <Card title="🇻🇳 Vietnamese" />

  <Card title="🇯🇵 Japanese" />

  <Card title="🇨🇳 Chinese" />

  <Card title="🇸🇦 Arabic" />
</CardGroup>

### Currency Localization

The dashboard displays prices in your local currency:

* **Euro (€)**: France, Germany, Spain, Italy, Portugal, Ireland, Belgium
* **Dollar (\$)**: United States
* **Pound (£)**: United Kingdom
* **Yen (¥)**: Japan, China
* **Saudi Riyal (ر.س)**: Saudi Arabia
* **And many more...**

<Note>
  🌍 **Right-to-Left (RTL) Support** - For Arabic users, the dashboard automatically switches to RTL layout, including modals, filters, and all UI elements.
</Note>

### Number Formatting

Numbers are formatted according to your region:

* **Arabic Countries**: Use Arabic-Indic numerals (٠-٩)
* **Western Countries**: Use standard numerals (0-9)
* **Decimal Separators**: Automatically adjusted (comma vs. period)

## Best Practices

<AccordionGroup>
  <Accordion icon="star" title="Optimize Your Dashboard Layout">
    * Place your most critical KPIs at the top
    * Group related metrics together
    * Use chart visualizations for trending data
    * Hide KPIs you rarely reference
  </Accordion>

  <Accordion icon="clock" title="Regular Monitoring">
    * Check your dashboard daily for real-time insights
    * Set up alerts for critical threshold breaches
    * Review weekly trends to identify patterns
    * Compare period-over-period performance
  </Accordion>

  <Accordion icon="star" title="Set Meaningful Goals">
    * Define target values for key metrics
    * Track progress against industry benchmarks
    * Adjust targets based on seasonal variations
    * Celebrate wins when targets are achieved
  </Accordion>

  <Accordion icon="chart-line" title="Leverage Charts Effectively">
    * Enable charts for trending KPIs
    * Use appropriate chart types for your data
    * Configure data ranges based on your analysis needs
    * Export chart data for presentations
  </Accordion>
</AccordionGroup>

## Troubleshooting

### Common Issues

<AccordionGroup>
  <Accordion icon="exclamation-triangle" title="KPIs Not Updating">
    **Solution:**

    * Refresh your browser page
    * Check your internet connection
    * Verify data source permissions
    * Contact support if issue persists
  </Accordion>

  <Accordion icon="eye-slash" title="Missing KPIs">
    **Solution:**

    * Open KPI Settings and check if they're hidden
    * Use the search function to locate specific KPIs
    * Verify you have appropriate permissions
    * Reset to defaults if needed
  </Accordion>

  <Accordion icon="chart-line" title="Charts Not Displaying">
    **Solution:**

    * Ensure chart visualization is enabled in KPI settings
    * Check if there's sufficient data for the selected time range
    * Clear browser cache and cookies
    * Try a different browser
  </Accordion>

  <Accordion icon="language" title="Wrong Language/Currency">
    **Solution:**

    * Go to Settings and update your country selection
    * Log out and log back in to refresh preferences
    * Clear browser cookies
    * Contact admin to update account settings
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Explore Vehicle Inspection" icon="magnifying-glass" href="/features/inspection/overview">
    Learn how to inspect and assess vehicle conditions
  </Card>

  <Card title="Pricing & Valuation" icon="dollar-sign" href="/features/pricing/overview">
    Discover intelligent pricing and market valuation tools
  </Card>

  <Card title="Marketing Campaigns" icon="megaphone" href="/features/remarketing/overview">
    Create and manage multi-platform marketing campaigns
  </Card>

  <Card title="API Integration" icon="code" href="/api-reference/introduction">
    Integrate dashboard metrics into your own systems
  </Card>
</CardGroup>

## Support

Need help with your dashboard? We're here to assist:

* 📧 **Email**: [support@steerai.autos](mailto:support@steerai.autos)
* 📚 **Documentation**: [docs.steerai.autos](https://docs.steerai.autos)
* 💬 **Live Chat**: Available in-app during business hours
* 🎓 **Training Sessions**: Schedule a personalized walkthrough

<Tip>
  **Pro Tip**: Take advantage of our video tutorials in the Help Center for visual step-by-step guides on dashboard features.
</Tip>