# Create Pie Chart Breakdowns

#### Overview

Pie Chart widgets provide proportional data visualization with group-by capabilities for categorical analysis. This guide covers Pie Chart configuration based on the verified Analytics implementation.

**Perfect for**: Category proportions, market share analysis, budget breakdowns, composition analysis

**Time Required**: 5-10 minutes per pie chart widget

#### When to Use Pie Charts

Pie charts excel at showing proportional relationships and are ideal for:

{% tabs %}
{% tab title="Proportional Analysis" %}
**Part-to-whole relationships**:

* Market share analysis by category
* Revenue distribution across product lines
* Traffic source composition
* Budget allocation breakdowns

**Why Pie Charts**: Instantly show how parts contribute to the total
{% endtab %}

{% tab title="Category Composition" %}
**Categorical breakdown visualization**:

* Product category performance distribution
* Geographic revenue composition
* Channel contribution analysis
* Segment proportion analysis

**Why Pie Charts**: Visual representation of category relationships and dominance
{% endtab %}

{% tab title="Simple Comparisons" %}
**Clear proportion comparison**:

* Compare category contributions at a glance
* Identify dominant categories quickly
* Understand relative category importance
* Visualize balance across categories

**Why Pie Charts**: Intuitive visualization for proportion-based insights
{% endtab %}

{% tab title="Executive Reporting" %}
**Stakeholder-friendly visualization**:

* Easy-to-understand business metric breakdowns
* Clear visual communication of proportions
* Professional presentation format
* Non-technical audience accessibility

**Why Pie Charts**: Universal visual language for proportional data
{% endtab %}
{% endtabs %}

#### Prerequisites

* Analytics dashboard access with Edit permissions
* Data with categorical dimensions for meaningful breakdowns
* Understanding of your business segments and categories
* Familiarity with verified Analytics features:
  * Dashboard creation
  * Widget basics
  * Group-by concepts

#### Creating Your First Pie Chart

{% stepper %}
{% step %}
**Add Pie Chart Widget**

From your dashboard, click the **dot menu (⋮)** in the header area.

Select **"Create widget"** to open the WidgetForm side panel (AnalyticsDetail.tsx:279-283).

Choose **"Pie Chart"** from the widget type options (PieChart/PieChart.tsx implementation).
{% endstep %}

{% step %}
**Configure Pie Chart Specifications**

Configure your Pie Chart widget in the **WidgetForm side panel**:

**Pie Chart Specifications** (PieChart/PieChart.tsx):

* **Grid Size**: 4x6 (compact size optimal for proportion visualization)
* **Single Metric**: One metric per pie chart widget
* **API Metrics Support**: Choose from available API metrics
* **Group-By Capabilities**: Categorical grouping creates pie segments

**Configuration Requirements**:

* **Metric Selection**: Choose single metric from available options
* **Group By**: Select categorical dimension that creates meaningful segments
* **Data Availability**: Ensure metric and category have sufficient data for visualization
  {% endstep %}

{% step %}
**Select Metric and Grouping**

**Metric Selection**: Choose a metric that makes sense for proportional analysis:

* **Revenue metrics**: Show revenue distribution across categories
* **Volume metrics**: Display count or volume breakdowns
* **Activity metrics**: Visualize engagement or activity proportions
* **Business metrics**: Any metric with meaningful categorical breakdown

**Group-By Configuration**: Select categorical dimension that creates pie segments:

* **Product Categories**: Break down by product types or lines
* **Geographic Regions**: Show distribution across locations
* **Traffic Sources**: Display source contribution proportions
* **Business Segments**: Analyze by customer segments or business units

**Example Configuration**:

* **Metric**: Total Revenue
* **Group By**: Product Category
* **Result**: Pie chart showing revenue proportion per product category
  {% endstep %}

{% step %}
**Position and Save**

**Widget Specifications**:

* **Grid Size**: 4x6 (verified Pie Chart dimensions)
* **Auto-positioning**: Widget places in next available 4x6 grid space
* **Title Configuration**: Set descriptive title indicating metric and breakdown
* **Segment Display**: Categories appear as pie segments with proportional sizing

Click **"Save"** in the side panel to add the widget to your dashboard.
{% endstep %}
{% endstepper %}

#### Understanding Your Pie Chart

Your completed pie chart displays proportional categorical information:

**Key Pie Chart Components**

{% tabs %}
{% tab title="Pie Segments" %}
**Proportional Visualization**: Each segment represents category contribution

* **Segment Size**: Proportional to category's metric value
* **Visual Clarity**: Segments clearly distinguish different categories
* **Proportional Accuracy**: Segment sizes accurately reflect data proportions
* **Category Identification**: Clear visual distinction between categories
  {% endtab %}

{% tab title="Category Labels" %}
**Segment Identification**: Clear labeling of pie chart categories

* **Category Names**: Descriptive labels for each pie segment
* **Data Values**: Metric values or percentages may be displayed
* **Legend Integration**: Category identification through visual legend
* **Readable Format**: Appropriate text sizing and positioning
  {% endtab %}

{% tab title="Static Display" %}
**Data Presentation**: Visual data display without interactive features

* **No Segment Interaction**: Pie segments display data without click functionality
* **No Filtering**: Segments don't provide click-to-filter capabilities
* **Static Proportions**: Proportions update only when dashboard filters change
* **Display Only**: Chart provides visualization without interactive manipulation
  {% endtab %}
  {% endtabs %}

#### Pie Chart Configuration Best Practices

**Optimal Category Selection**

**Effective Group-By Choices**:

* **Limit Categories**: 3-8 categories work best for pie chart readability
* **Meaningful Segments**: Categories should have significant enough values to be visible
* **Logical Grouping**: Categories should be mutually exclusive and collectively comprehensive
* **Business Relevance**: Choose categories that align with business decision-making needs

**Metric Selection Guidelines**

{% tabs %}
{% tab title="Proportional Metrics" %}
**Choose metrics that make sense for proportion analysis**:

* **Revenue**: Financial contribution by category
* **Volume**: Count or quantity distribution
* **Activity**: Engagement or usage proportions
* **Time**: Time allocation across categories

**Avoid**: Metrics where proportional analysis isn't meaningful (like conversion rates)
{% endtab %}

{% tab title="Data Quality" %}
**Ensure quality proportional analysis**:

* **Sufficient Data**: All categories should have meaningful data values
* **Recent Data**: Use appropriate time ranges for current analysis
* **Complete Categories**: Ensure all relevant categories are included
* **Balanced Distribution**: Very small segments may be difficult to see

**Goal**: Clear, readable proportional visualization with actionable insights
{% endtab %}
{% endtabs %}

#### Common Pie Chart Use Cases

**Market Share Analysis**

**Business Goal**: Understand category contribution to total market/business

**Setup**:

* **Metric**: Revenue, sales volume, or market-relevant metric
* **Group By**: Product categories, business units, or market segments
* **Time Range**: Appropriate period for market analysis (quarterly, annually)

**Analysis Insights**:

* **Dominant Categories**: Which categories drive most business
* **Market Balance**: How evenly distributed market/business is
* **Growth Opportunities**: Smaller segments with growth potential
* **Resource Allocation**: Where to focus investment and attention

**Example**: Revenue pie chart grouped by product category shows which product lines generate most revenue

**Traffic Source Composition**

**Business Goal**: Understand traffic/visitor source proportions

**Setup**:

* **Metric**: Sessions, users, or traffic volume metric
* **Group By**: Traffic source, campaign type, or channel category
* **Time Range**: Recent period appropriate for marketing analysis

**Analysis Insights**:

* **Channel Performance**: Which sources drive most traffic
* **Diversification**: How dependent business is on specific sources
* **Marketing Effectiveness**: Contribution of various marketing efforts
* **Investment Priorities**: Where to focus marketing budget and effort

**Budget Allocation Visualization**

**Business Goal**: Display resource allocation across categories

**Setup**:

* **Metric**: Budget amount, cost, or investment metric
* **Group By**: Department, campaign, project, or expense category
* **Time Range**: Budget period (monthly, quarterly, annually)

**Analysis Insights**:

* **Resource Distribution**: How resources are allocated across areas
* **Budget Balance**: Whether allocation matches strategic priorities
* **Optimization Opportunities**: Categories with disproportionate allocation
* **Strategic Alignment**: Whether spending aligns with business goals

#### Pie Chart Design Best Practices

**Visual Design Guidelines**

**Optimal Pie Chart Design**:

* **Segment Limit**: Maximum 8 categories for readability
* **Category Consolidation**: Combine small categories into "Other" if needed
* **Logical Ordering**: Arrange segments in logical order (largest to smallest, alphabetical, etc.)
* **Color Distinction**: Ensure segments are visually distinct

**Data Preparation Tips**

<details>

<summary>Category Management</summary>

**Effective Category Preparation**:

* **Significant Categories**: Include categories with meaningful contribution (typically >2-3% of total)
* **"Other" Grouping**: Consolidate very small categories into "Other" segment
* **Mutually Exclusive**: Ensure categories don't overlap or double-count
* **Comprehensive**: Categories should account for complete total

**Benefits**: Clean, readable pie charts with actionable insights

</details>

<details>

<summary>Metric Selection Strategy</summary>

**Choose Appropriate Metrics**:

* **Additive Metrics**: Use metrics that logically add up to meaningful totals
* **Proportional Relevance**: Select metrics where proportional analysis provides insights
* **Business Context**: Choose metrics aligned with business questions and decisions
* **Data Availability**: Ensure metric has sufficient data across all categories

**Avoid**: Metrics like averages or ratios that don't represent proportional relationships

</details>

#### Troubleshooting Pie Charts

**Pie Chart Shows Uneven or Hard-to-Read Segments**

**Common Causes & Solutions**:

1. **Too Many Small Categories**
   * **Problem**: Many tiny segments make chart unreadable
   * **Solution**: Combine small categories into "Other" or filter to top categories
   * **Prevention**: Limit to 5-8 most significant categories
2. **One Dominant Category**
   * **Problem**: One category overwhelms others, making comparison difficult
   * **Solution**: Consider if pie chart is appropriate, or use filtering to focus on smaller segments
   * **Alternative**: Bar chart might be better for extreme proportional differences
3. **Category Data Issues**
   * **Problem**: Categories have insufficient data or unexpected values
   * **Solution**: Adjust time range, check data availability, verify group-by selection
   * **Check**: Ensure categories have meaningful data for selected time period

**Pie Chart Appears Empty or Shows No Data**

**Diagnostic Steps**:

1. **Metric Availability**: Verify selected metric has data for chosen time range
2. **Group-By Data**: Confirm group-by dimension has categorical data
3. **Filter Impact**: Check if dashboard filters are excluding data
4. **Time Range**: Expand time range to include periods with data

**Performance or Display Issues**

**Optimization Strategies**:

* **Limit Categories**: Fewer segments improve chart readability and performance
* **Appropriate Time Ranges**: Use time periods that provide meaningful data
* **Simple Grouping**: Choose straightforward categorical dimensions
* **Dashboard Balance**: Consider pie chart size relative to other dashboard widgets

#### FAQ

<details>

<summary>How many categories should I include in a pie chart?</summary>

**Optimal Range**: 3-7 categories for best readability and analysis value

* **Fewer than 3**: Consider using Big Numbers or simple comparison
* **3-7 categories**: Perfect for pie chart visualization
* **More than 8**: Chart becomes difficult to read; consider bar chart or consolidation

**Management Strategy**: Combine small categories into "Other" segment or filter to show only top categories

</details>

<details>

<summary>When should I use pie charts vs bar charts?</summary>

**Use Pie Charts When**:

* Showing part-to-whole relationships (proportions of total)
* Categories represent composition of single total
* Emphasizing relative contribution rather than absolute values
* Audience needs intuitive proportion understanding

**Use Bar Charts When**:

* Comparing absolute values across categories
* Categories don't represent parts of single whole
* Need to show exact values and rankings clearly
* Many categories or large value differences exist

**Rule of Thumb**: Pie for composition, bars for comparison

</details>

<details>

<summary>Can I interact with pie chart segments (click, filter, drill-down)?</summary>

**Pie Chart Limitations** (verified implementation):

* **No Segment Interaction**: Pie segments provide display only without click functionality
* **No Filtering**: Segments don't support click-to-filter capabilities
* **Static Display**: Chart updates only when dashboard-level filters change
* **Display Purpose**: Charts provide visualization without interactive manipulation

**Alternatives**:

* **Dashboard Filters**: Use dashboard-level filtering to focus on specific categories
* **Multiple Charts**: Create separate pie charts with different filter focuses
* **Bar Charts**: Consider Bar Charts with group-by for more detailed categorical analysis

</details>

<details>

<summary>What's the difference between Pie Charts and other visualization types?</summary>

**Pie Chart Advantages**:

* **Proportion Focus**: Excellent for part-to-whole relationship visualization
* **Intuitive Understanding**: Universal visual language for proportions
* **Compact Display**: 4x6 grid size efficient for dashboard space
* **Executive Friendly**: Clear visual communication for stakeholder reporting

**Comparison with Other Widgets**:

* **vs Bar Charts**: Pie shows proportions, bars show comparisons and rankings
* **vs Line Charts**: Pie shows current composition, lines show trends over time
* **vs Tables**: Pie provides visual overview, tables provide detailed data
* **vs Big Numbers**: Pie shows breakdown, Big Numbers show single totals

**Best Use**: When proportion and composition understanding is the primary analysis goal

</details>

<details>

<summary>How do I handle categories with very small values?</summary>

**Small Category Management**:

* **"Other" Consolidation**: Combine categories under 3-5% into "Other" segment
* **Top N Filtering**: Show only top 5-7 categories by value
* **Threshold Filtering**: Display only categories above minimum threshold
* **Separate Analysis**: Create dedicated analysis for small categories if important

**Implementation**:

* **Dashboard Filters**: Use filtering to focus on significant categories
* **Data Preparation**: Consider data aggregation strategies
* **Multiple Views**: Create overview pie chart and detailed analysis separately
* **Context**: Provide total values to give context for small segments

**Goal**: Maintain chart readability while preserving important analytical insights

</details>

***

{% hint style="info" %}
**Documentation Verification**: All Pie Chart widget features and configuration options described in this guide have been verified against the actual Analytics codebase. Single metric support, group-by capabilities, grid sizing, and display behavior are accurately documented based on PieChart/PieChart.tsx implementation.
{% endhint %}

**Related Guides:**

* Setup Bar Chart Comparisons
* Configure Big Number KPIs
* Build Detailed Table Analysis
* Create Your First Dashboard


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.crobox.com/how-to-guides/analytics/essential-guides/create-pie-chart-breakdowns.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.