---
schema_version: "1"
id: 6edd3e3e1063538620db36d634846b2ba712bf9197fc98379a3734b506abcdb0
title: apex:scatterSeries
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/salesforce-pages-developers-guide/guides/pages/components/pages-compref-scatterseries.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-pages-developers-guide/guide/pages-compref-scatterseries.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 148fd6fe6ee60561642c60c761fe1c3a4a2b13ce1bfd7da5b753a060c057545d
products:
  - Visualforce Developer Guide
  - Platform Developer Content
---

# apex:scatterSeries

A data series to be rendered as individual (not connected) points in a linear Visualforce chart. At a minimum you must specify the fields in the data collection to use as X and Y values for each point, as well as the X and Y axes to scale against.

**Note:** This component must be enclosed within an `<apex:chart>` component. You can have multiple `<apex:scatterSeries>` components in a single chart. You can also add `<apex:areaSeries>`, `<apex:barSeries>`, and `<apex:lineSeries>` components, but the results might not be very readable.

## Example

```apex
<!-- Page: -->
<apex:chart height="530" width="700" animate="true" data="{!data}">
    <apex:scatterSeries xField="data1" yField="data2" 
        markerType="circle" markerSize="3"/>
    <apex:axis type="Numeric" position="bottom" fields="data1" 
        title="Torque" grid="true">
        <apex:chartLabel/>
    </apex:axis>
    <apex:axis type="Numeric" position="left" fields="data2" 
        title="Lateral Motion" grid="true">
        <apex:chartLabel/>
    </apex:axis>
</apex:chart>
```

## Attributes

|Attribute Name|Attribute Type|Description|Required?|API Version|Access|
|--------------|--------------|-----------|---------|-----------|------|
|`axis`|String|Which axis this chart series should bind to. Must be one of the four edges of the chart: left, right, top, or bottom The axis bound to must be defined by a sibling `<apex:axis>` component.| |26.0||
|`highlight`|Boolean|A Boolean value that specifies whether each point should be highlighted when the mouse pointer passes over it. If not specified, this value defaults to true.| |26.0||
|`id`|String|An identifier that allows the chart component to be referenced by other components on the page.| |26.0|global|
|`markerFill`|String|The color of data point markers for this series, specified as an HTML-style (hexadecimal) color.| |26.0||
|`markerSize`|Integer|The size of each data point marker for this series.| |26.0||
|`markerType`|String|The shape of each data point marker for this series. Valid options are: circle or cross If not specified, the marker shape is chosen from a sequence of shapes.| |26.0||
|`rendered`|Boolean|A Boolean value that specifies whether the chart series is rendered in the chart. If not specified, this value defaults to true.| |26.0||
|`rendererFn`|String|A string that specifies the name of a JavaScript function that augments or overrides how each data point is rendered. Implement to provide additional styling or to augment data.| |26.0||
|`showInLegend`|Boolean|A Boolean value that specifies whether this chart series should be added to the chart legend. If not specified, this value defaults to true.| |26.0||
|`tips`|Boolean|A Boolean value that specifies whether to display a tooltip for each data point marker when the mouse pointer passes over it. The format of the tip is \<xField>: \<yField>. If not specified, this value defaults to true.| |26.0||
|`title`|String|The title of this chart series, which is displayed in the chart legend.| |26.0||
|`xField`|String|The field in each record provided in the chart data from which to retrieve the x-axis value for each data point in the series. This field must exist in every record in the chart data.|Yes|26.0||
|`yField`|String|The field in each record provided in the chart data from which to retrieve the y-axis value for each data point in the series. This field must exist in every record in the chart data.|Yes|26.0||

**See Also**  


-   [apex:chart](https://developer.salesforce.com/docs/platform/salesforce-pages-developers-guide/guide/pages-compref-chart.md)
-   [Other Linear Series Charts](https://developer.salesforce.com/docs/platform/salesforce-pages-developers-guide/charting/pages-charting-appearance-linear-charts.md)
-   [Visualforce Charting](https://developer.salesforce.com/docs/platform/salesforce-pages-developers-guide/charting/pages-charting.md)