--- title: "Line Chart" slug: "line-chart-options" description: "Customize Line Charts in Pigment to visualize trends, compare metrics, and adjust colors, markers, and axes for clearer, data-driven storytelling." tags: ["Chart Customization", "Line Charts", "Reporting Data Visualization "] updated: 2026-06-05T13:02:27Z published: 2026-06-05T13:02:27Z --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.pigment.com/llms.txt > Use this file to discover all available pages before exploring further. # Line Chart Line charts visualize trends and progression in data across multiple groups over time. This article covers how to prepare your View and configure Line chart display settings. ![Line chart displaying product sales data for various cleaning items over time.](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/Line chart.png) ## Before you begin How you set up your View affects how data appears in the chart. The following articles can help you prepare your data before customizing your chart: - Use the [Pivot feature](/v1/docs/change-views-pivot-pigment) to change the axis and add/remove Dimensions. - Use the [Filter feature](/v1/docs/filter-data-pigment) to remove Items from a List. - Use the [Sort feature](/v1/docs/sort-data-in-pigment/#sort-your-metric-or-table-data) to change the order of Items in the chart. ## Configure Line charts Use the following settings to customize the appearance and layout of Line charts. ### Line chart settings | Setting | Description | Options | | --- | --- | --- | | **Line style** | Configures how lines and data points are displayed. | - **Line**. Displays a line connecting data points. - **Dotted line**. Displays a line connecting data points with visible dots. - **Dots**. Displays dots for each data point without connecting lines. | | **Line shape** | Configures the shape of the curve connecting series data points. | - **Linear.** Displays straight line segments connecting points. - **Basis**. Displays smooth interpolated curves between points. - **Smooth.** Displays smooth curves between points. - **Step**. Displays stepped line segments between points. - **Natural.**Displays natural curved interpolation between points. | | **Line width** | Controls the width of each individual line. | Move the slider to increase or reduce line thickness. | | **Dashed lines** | Controls whether lines are displayed as solid or dashed. Not available when **Line style** is set to **Dotted line**. | Toggle on/off *(Turned off by default)* | | **Stacked values** | Series values are added on the Y-axis, so each consecutive series appears above the last with their value added to the previous number. | Toggle on/off *(Turned off by default)* | | **Show area** | Fills the area under each line. | Toggle on/off *(Turned off by default)* | | **Area opacity** | Controls the opacity of the chart area. | Move the slider to increase or reduce area opacity. | ### Line labels | Setting | Description | Options | | --- | --- | --- | | **Show labels** | Shows or hides labels that display the value of each data point. | Toggle on/off *(Turned off by default)* | | **Allow label overlap** | Allows labels to overlap so labels remain visible even when data points are too close together. | Toggle on/off *(Turned off by default)* | | **High-contrast labels** | Increase label contrast to improve readability and visibility against chart backgrounds. | Toggle on/off *(Turned off by default)* | ### X-axis | Setting | Description | Options | | --- | --- | --- | | **Show gridlines** | Shows or hides X-axis gridlines in the chart. | Toggle on/off *(Turned off by default)* | | **Label orientation** | Configures the orientation of X-axis labels. Longer labels automatically wrap. Use the diagonal or vertical option to improve readability and display more labels. **Diagonal labels** **are not supported** when multiple dimensions are displayed on the axis at the same time. | Horizontal, Vertical, and Diagonal | | **Allow label overlap** | Allows labels to overlap so labels remain visible on X-axis even when data points are too close together. | Toggle on/off *(Turned off by default)* | ### Y-axis | Setting | Description | Options | | --- | --- | --- | | **Show axis** | Shows or hides the Y-axis in the chart. | Toggle on/off *(Turned on by default)* | | **Show gridlines** | Shows or hides the Y-axis gridlines in the chart. | Toggle on/off *(Turned on by default)* | | **Axis scale** | Configures how the Y-axis scale is calculated. | Auto or Fixed *(Auto by default)* | | **Start axis at zero** | Starts the Y-axis at zero. Only available when Axis scale is set to Auto. | Toggle on/off *(Turned off by default)* | ### Style > [!NOTE] > ℹ️ **Note** > > Use the following settings to configure chart colours and themes. For detailed instructions and available colour options, see [Customize Chart Colors](/v1/docs/customize-chart-colors). | Setting | Description | Options | | --- | --- | --- | | **Color by** | Determines how colours are assigned to chart series. | **Theme** Use a predefined colour palette. **Dimension Items** Assign a consistent colour to each Dimension Item across charts. | | **Color theme** | Applies a predefined colour palette to chart series. Only available when **Color by**is set to **Theme**. | Pigment preset themes and Workspace palettes. | | **Series colors** | Allows you to customize colours for individual series. Pigment preserves series colour order when switching between themes. | Edit | ### Legend | Setting | Description | Options | | --- | --- | --- | | **Show legend** | Shows or hides the chart legend. | Toggle on/off *(Turned on by default)* | | **Legend position** | Sets the position of the legend. The legend becomes scrollable when additional series are displayed. | Bottom right, Top right, Bottom centered, or Top centered |