diff --git a/src/scatter-plot.js b/src/scatter-plot.js
index a945d2d5a..6d127539d 100644
--- a/src/scatter-plot.js
+++ b/src/scatter-plot.js
@@ -175,6 +175,20 @@ dc.scatterPlot = function (parent, chartGroup) {
         return _chart;
     };
 
+    /**
+     * Get or set the symbol generator. By default `dc.scatterPlot` will use
+     * {@link https://github.com/d3/d3-3.x-api-reference/blob/master/SVG-Shapes.md#symbol d3.svg.symbol()}
+     * to generate symbols. `dc.scatterPlot` will set the
+     * {@link https://github.com/d3/d3-3.x-api-reference/blob/master/SVG-Shapes.md#symbol_size size accessor}
+     * on the symbol generator.
+     * @method customSymbol
+     * @memberof dc.scatterPlot
+     * @instance
+     * @see {@link https://github.com/d3/d3-3.x-api-reference/blob/master/SVG-Shapes.md#symbol d3.svg.symbol}
+     * @see {@link https://stackoverflow.com/questions/25332120/create-additional-d3-js-symbols Create additional D3.js symbols}
+     * @param {String|Function} [customSymbol=d3.svg.symbol()]
+     * @returns {String|Function|dc.scatterPlot}
+     */
     _chart.customSymbol = function (customSymbol) {
         if (!arguments.length) {
             return _symbol;