This is documentation for Mathematica 7, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.1)


is an option to charting functions such as BarChart that specifies the graphics to use as the basis for bars or other chart elements.
  • The final rendered form of each chart element is obtained by replicating or stretching copies of the base object so as to fill the necessary shape or region.
Noneleave chart elements blank
Automaticuse a preset default graphic
gfill chart elements with copies of g
{g,All}stretch a single g to fill each chart element
{g,{w,h}}use copies of g with width w and height h
{g1,g2,...}use gi for the i^(th) element in each dataset
{spec1,spec2,...}use different specifications for different data dimensions
  • With a chart element specification of the form {g, {w, h}}, the following width and height specifications can be given:
sexplicit size in ordinary plot coordinates
Scaled[s]size given as a fraction of the chart element region
Automaticsize determined by the original aspect ratio of g
Allsize that fills the chart element region
  • When objects g are rendered for chart elements, their base styles are inherited from the styles defined for each chart element.
  • Settings for BarOrigin and similar options do not affect either the orientation in which objects g are rendered, or the identification of w and h as width and height.
  • With ChartElements->{g1, g2, ...}, the gi are used cyclically to render the chart elements for successive elements in each dataset.
  • With ChartElements->{spec1, spec2, ...}, the speci are used as chart element specifications for successive dimensions in nested lists of datasets.
  • ChartElements->{g1, g2, ...} is effectively taken to give a specification for the innermost dimension of nested lists of datasets.
New in 7