Template:Bar chart/doc#Empty cells

{{notice|{{tl|Bar chart}} handles up to 4 columns and 30 rows of data.}}

This template can be used to create a horizontal bar chart, scrolling down a page, in a format which can be parsed by text-based web browsers. The data items can be simple numbers, or the result of calculations based on template parameters.

Each data number (data1=7, data2=23...), in column 1, is scaled to parameter "data_max=" and the bars are sized by width in em units, such as "bar_width=16". By default, the data numbers are shown within each bar, but might display outside a bar when a relatively small number generates a short bar. Each bar can also have a comment, such as "comment7=xx" to show "(xx)" after the number in bar 7.

For a 2-column bar chart, the 2nd column items have prefix "col2_" such as scale maximum, col2_data_max=110, and col2_data3=67 with col2_comment3=zz. See below: "Example with two data columns". Each bar chart can be formatted typically within 1/5 second.

Usage and parameters

:The use of text other than numbers and proper punctuation in a data field will result in an Expression error.

{{Bar chart

| title =

| table_width =

| bar_width =

| label_type =

| label1 =

| label2 =

...

| label30 =

| data_type =

| data_max =

| data1 =

| comment1 =

| data2 =

| comment2 =

...

| data30 =

| comment30 =

| col2_data_type=

| col2_data_max =

| col2_data1 =

| col2_comment1 =

| col2_data2 =

| col2_comment2 =

...

| col2_data30 =

| col2_comment30=

}}

Alignment

To float the bar chart on the right of the page, use

| float = right

To float the bar chart on the left of the page, use

| float = left

To float the bar chart to the center of the page, use

| float = center

The default is none.

Caption

To add a caption to the bottom of the chart, use

| caption =

Empty cells

Use – or — (or a similar dash character) as a placeholder in a cell where there is no data available. Leaving a cell completely blank can sometimes cause columns to be misaligned.

Example

{{Bar chart

| title = Largest cities of Foo, 2009 Census

| bar_width = 35

| data_max = 600000

| label_type = City | data_type = Population

| label1 = City1 | data1 = 540,921

| label2 = City2 | data2 = 194,343

| label3 = City3 | data3 = 190,414

| label4 = City4 | data4 = 134,669

| label5 = City5 | data5 = 114,983

}}

{{Bar chart

| title = Largest cities of Foo, 2009 Census

| bar_width = 35

| data_max = 600000

| label_type = City | data_type = Population

| label1 = City1 | data1 = 540,921

| label2 = City2 | data2 = 194,343

| label3 = City3 | data3 = 190,414

| label4 = City4 | data4 = 134,669

| label5 = City5 | data5 = 114,983

}}

Example with comments

{{Bar chart

| title = Annual revenue passenger statistics

| label_type = Year

| data_type = Passengers (% change from prior year)

| data_max = 170,000

| label3 = 2003-04 | data3 = 110,649 | comment3 = +17.8%

| label4 = 2004-05 | data4 = 130,429 | comment4 = +17.9%

| label5 = 2005-06 | data5 = 138,547 | comment5 = +6.2%

| label6 = 2006-07 | data6 = 138,844 | comment6 = +0.2%

| label7 = 2007-08 | data7 = 149,544 | comment7 = +7.7%

| label8 = 2008-09 | data8 = 148,435 | comment8 = -0.7%

| label9 = 2009-10 | data9 = 168,147 | comment9 = +13.3%

}}

{{Bar chart

| title = Annual revenue passenger statistics

| label_type = Year

| data_type = Passengers (% change from prior year)

| data_max = 170,000

| label3 = 2003-04 | data3 = 110,649 | comment3 = +17.8%

| label4 = 2004-05 | data4 = 130,429 | comment4 = +17.9%

| label5 = 2005-06 | data5 = 138,547 | comment5 = +6.2%

| label6 = 2006-07 | data6 = 138,844 | comment6 = +0.2%

| label7 = 2007-08 | data7 = 149,544 | comment7 = +7.7%

| label8 = 2008-09 | data8 = 148,435 | comment8 = -0.7%

| label9 = 2009-10 | data9 = 168,147 | comment9 = +13.3%

}}

Example with two data columns

{{Bar chart

| title = Annual passenger and aircraft statistics

| bar_width = 20

| label_type = Fiscal year

| label1 = 2001-02

| label2 = 2002-03

| label3 = 2003-04

| label4 = 2004-05

| label5 = 2005-06

| label6 = 2006-07

| label7 = 2007-08

| label8 = 2008-09

| label9 = 2009-10

| data_type = Revenue passengers

| data_max = 66,000

| data1 = 20,194

| data2 = 22,057

| data3 = 34,794

| data4 = 49,234

| data5 = 57,732

| data6 = 64,881

| data7 = 63,904

| data8 = 54,718

| data9 = 52,210

| col2_data_type = Aircraft movements

| col2_data_max = 3,200

| col2_data1 = 2,281

| col2_data2 = 2,633

| col2_data3 = 2,664

| col2_data4 = 2,754

| col2_data5 = 3,004

| col2_data6 = 2,956

| col2_data7 = 2,912

| col2_data8 = 2,811

| col2_data9 = 2,791

}}

{{Bar chart

| title = Annual passenger and aircraft statistics

| bar_width = 20

| label_type = Fiscal year

| label1 = 2001-02

| label2 = 2002-03

| label3 = 2003-04

| label4 = 2004-05

| label5 = 2005-06

| label6 = 2006-07

| label7 = 2007-08

| label8 = 2008-09

| label9 = 2009-10

| data_type = Revenue passengers

| data_max = 66,000

| data1 = 20,194

| data2 = 22,057

| data3 = 34,794

| data4 = 49,234

| data5 = 57,732

| data6 = 64,881

| data7 = 63,904

| data8 = 54,718

| data9 = 52,210

| col2_data_type = Aircraft movements

| col2_data_max = 3,200

| col2_data1 = 2,281

| col2_data2 = 2,633

| col2_data3 = 2,664

| col2_data4 = 2,754

| col2_data5 = 3,004

| col2_data6 = 2,956

| col2_data7 = 2,912

| col2_data8 = 2,811

| col2_data9 = 2,791

}}

Template data

{

"params": {

"float": {},

"table_width": {},

"title": {},

"label_type": {},

"bar_width": {},

"data_type": {},

"col1_data_type": {},

"col2_data_type": {},

"col3_data_type": {},

"col4_data_type": {},

"col5_data_type": {},

"col6_data_type": {},

"col7_data_type": {},

"col8_data_type": {},

"col9_data_type": {},

"col1_data1": {},

"data1": {},

"label1": {},

"col1_data_max": {},

"data_max": {},

"col1_comment1": {},

"comment1": {},

"col2_data1": {},

"col2_data_max": {},

"col2_comment1": {},

"col3_data1": {},

"col3_data_max": {},

"col3_comment1": {},

"col4_data1": {},

"col4_data_max": {},

"col4_comment1": {},

"col5_data1": {},

"col5_comment1": {},

"col6_data1": {},

"col6_comment1": {},

"col7_data1": {},

"col7_comment1": {},

"col8_data1": {},

"col8_comment1": {},

"col9_data1": {},

"col9_comment1": {},

"col1_data2": {},

"data2": {},

"label2": {},

"col1_comment2": {},

"comment2": {},

"col2_data2": {},

"col2_comment2": {},

"col3_data2": {},

"col3_comment2": {},

"col4_data2": {},

"col4_comment2": {},

"col5_data2": {},

"col5_comment2": {},

"col6_data2": {},

"col6_comment2": {},

"col7_data2": {},

"col7_comment2": {},

"col8_data2": {},

"col8_comment2": {},

"col9_data2": {},

"col9_comment2": {},

"col1_data3": {},

"data3": {},

"label3": {},

"col1_comment3": {},

"comment3": {},

"col2_data3": {},

"col2_comment3": {},

"col3_data3": {},

"col3_comment3": {},

"col4_data3": {},

"col4_comment3": {},

"col5_data3": {},

"col5_comment3": {},

"col6_data3": {},

"col6_comment3": {},

"col7_data3": {},

"col7_comment3": {},

"col8_data3": {},

"col8_comment3": {},

"col9_data3": {},

"col9_comment3": {},

"col1_data4": {},

"data4": {},

"label4": {},

"col1_comment4": {},

"comment4": {},

"col2_data4": {},

"col2_comment4": {},

"col3_data4": {},

"col3_comment4": {},

"col4_data4": {},

"col4_comment4": {},

"col5_data4": {},

"col5_comment4": {},

"col6_data4": {},

"col6_comment4": {},

"col7_data4": {},

"col7_comment4": {},

"col8_data4": {},

"col8_comment4": {},

"col9_data4": {},

"col9_comment4": {},

"col1_data5": {},

"data5": {},

"label5": {},

"col1_comment5": {},

"comment5": {},

"col2_data5": {},

"col2_comment5": {},

"col3_data5": {},

"col3_comment5": {},

"col4_data5": {},

"col4_comment5": {},

"col5_data5": {},

"col5_data_max": {},

"col5_comment5": {},

"col6_data5": {},

"col6_data_max": {},

"col6_comment5": {},

"col7_data5": {},

"col7_data_max": {},

"col7_comment5": {},

"col8_data5": {},

"col8_data_max": {},

"col8_comment5": {},

"col9_data5": {},

"col9_data_max": {},

"col9_comment5": {},

"col1_data6": {},

"data6": {},

"label6": {},

"col1_comment6": {},

"comment6": {},

"col2_data6": {},

"col2_comment6": {},

"col3_data6": {},

"col3_comment6": {},

"col4_data6": {},

"col4_comment6": {},

"col5_data6": {},

"col5_comment6": {},

"col6_data6": {},

"col6_comment6": {},

"col7_data6": {},

"col7_comment6": {},

"col8_data6": {},

"col8_comment6": {},

"col9_data6": {},

"col9_comment6": {},

"col1_data7": {},

"data7": {},

"label7": {},

"col1_comment7": {},

"comment7": {},

"col2_data7": {},

"col2_comment7": {},

"col3_data7": {},

"col3_comment7": {},

"col4_data7": {},

"col4_comment7": {},

"col5_data7": {},

"col5_comment7": {},

"col6_data7": {},

"col6_comment7": {},

"col7_data7": {},

"col7_comment7": {},

"col8_data7": {},

"col8_comment7": {},

"col9_data7": {},

"col9_comment7": {},

"col1_data8": {},

"data8": {},

"label8": {},

"col1_comment8": {},

"comment8": {},

"col2_data8": {},

"col2_comment8": {},

"col3_data8": {},

"col3_comment8": {},

"col4_data8": {},

"col4_comment8": {},

"col5_data8": {},

"col5_comment8": {},

"col6_data8": {},

"col6_comment8": {},

"col7_data8": {},

"col7_comment8": {},

"col8_data8": {},

"col8_comment8": {},

"col9_data8": {},

"col9_comment8": {},

"col1_data9": {},

"data9": {},

"label9": {},

"col1_comment9": {},

"comment9": {},

"col2_data9": {},

"col2_comment9": {},

"col3_data9": {},

"col3_comment9": {},

"col4_data9": {},

"col4_comment9": {},

"col5_data9": {},

"col5_comment9": {},

"col6_data9": {},

"col6_comment9": {},

"col7_data9": {},

"col7_comment9": {},

"col8_data9": {},

"col8_comment9": {},

"col9_data9": {},

"col9_comment9": {},

"col1_data10": {},

"data10": {},

"label10": {},

"col1_comment10": {},

"comment10": {},

"col2_data10": {},

"col2_comment10": {},

"col3_data10": {},

"col3_comment10": {},

"col4_data10": {},

"col4_comment10": {},

"col5_data10": {},

"col5_comment10": {},

"col6_data10": {},

"col6_comment10": {},

"col7_data10": {},

"col7_comment10": {},

"col8_data10": {},

"col8_comment10": {},

"col9_data10": {},

"col9_comment10": {},

"col1_data11": {},

"data11": {},

"label11": {},

"col1_comment11": {},

"comment11": {},

"col2_data11": {},

"col2_comment11": {},

"col3_data11": {},

"col3_comment11": {},

"col4_data11": {},

"col4_comment11": {},

"col5_data11": {},

"col5_comment11": {},

"col6_data11": {},

"col6_comment11": {},

"col7_data11": {},

"col7_comment11": {},

"col8_data11": {},

"col8_comment11": {},

"col9_data11": {},

"col9_comment11": {},

"col1_data12": {},

"data12": {},

"label12": {},

"col1_comment12": {},

"comment12": {},

"col2_data12": {},

"col2_comment12": {},

"col3_data12": {},

"col3_comment12": {},

"col4_data12": {},

"col4_comment12": {},

"col5_data12": {},

"col5_comment12": {},

"col6_data12": {},

"col6_comment12": {},

"col7_data12": {},

"col7_comment12": {},

"col8_data12": {},

"col8_comment12": {},

"col9_data12": {},

"col9_comment12": {},

"col1_data13": {},

"data13": {},

"label13": {},

"col1_comment13": {},

"comment13": {},

"col2_data13": {},

"col2_comment13": {},

"col3_data13": {},

"col3_comment13": {},

"col4_data13": {},

"col4_comment13": {},

"col5_data13": {},

"col5_comment13": {},

"col6_data13": {},

"col6_comment13": {},

"col7_data13": {},

"col7_comment13": {},

"col8_data13": {},

"col8_comment13": {},

"col9_data13": {},

"col9_comment13": {},

"col1_data14": {},

"data14": {},

"label14": {},

"col1_comment14": {},

"comment14": {},

"col2_data14": {},

"col2_comment14": {},

"col3_data14": {},

"col3_comment14": {},

"col4_data14": {},

"col4_comment14": {},

"col5_data14": {},

"col5_comment14": {},

"col6_data14": {},

"col6_comment14": {},

"col7_data14": {},

"col7_comment14": {},

"col8_data14": {},

"col8_comment14": {},

"col9_data14": {},

"col9_comment14": {},

"col1_data15": {},

"data15": {},

"label15": {},

"col1_comment15": {},

"comment15": {},

"col2_data15": {},

"col2_comment15": {},

"col3_data15": {},

"col3_comment15": {},

"col4_data15": {},

"col4_comment15": {},

"col5_data15": {},

"col5_comment15": {},

"col6_data15": {},

"col6_comment15": {},

"col7_data15": {},

"col7_comment15": {},

"col8_data15": {},

"col8_comment15": {},

"col9_data15": {},

"col9_comment15": {},

"col1_data16": {},

"data16": {},

"label16": {},

"col1_comment16": {},

"comment16": {},

"col2_data16": {},

"col2_comment16": {},

"col3_data16": {},

"col3_comment16": {},

"col4_data16": {},

"col4_comment16": {},

"col5_data16": {},

"col5_comment16": {},

"col6_data16": {},

"col6_comment16": {},

"col7_data16": {},

"col7_comment16": {},

"col8_data16": {},

"col8_comment16": {},

"col9_data16": {},

"col9_comment16": {},

"col1_data17": {},

"data17": {},

"label17": {},

"col1_comment17": {},

"comment17": {},

"col2_data17": {},

"col2_comment17": {},

"col3_data17": {},

"col3_comment17": {},

"col4_data17": {},

"col4_comment17": {},

"col5_data17": {},

"col5_comment17": {},

"col6_data17": {},

"col6_comment17": {},

"col7_data17": {},

"col7_comment17": {},

"col8_data17": {},

"col8_comment17": {},

"col9_data17": {},

"col9_comment17": {},

"col1_data18": {},

"data18": {},

"label18": {},

"col1_comment18": {},

"comment18": {},

"col2_data18": {},

"col2_comment18": {},

"col3_data18": {},

"col3_comment18": {},

"col4_data18": {},

"col4_comment18": {},

"col5_data18": {},

"col5_comment18": {},

"col6_data18": {},

"col6_comment18": {},

"col7_data18": {},

"col7_comment18": {},

"col8_data18": {},

"col8_comment18": {},

"col9_data18": {},

"col9_comment18": {},

"col1_data19": {},

"data19": {},

"label19": {},

"col1_comment19": {},

"comment19": {},

"col2_data19": {},

"col2_comment19": {},

"col3_data19": {},

"col3_comment19": {},

"col4_data19": {},

"col4_comment19": {},

"col5_data19": {},

"col5_comment19": {},

"col6_data19": {},

"col6_comment19": {},

"col7_data19": {},

"col7_comment19": {},

"col8_data19": {},

"col8_comment19": {},

"col9_data19": {},

"col9_comment19": {},

"col1_data20": {},

"data20": {},

"label20": {},

"col1_comment20": {},

"comment20": {},

"col2_data20": {},

"col2_comment20": {},

"col3_data20": {},

"col3_comment20": {},

"col4_data20": {},

"col4_comment20": {},

"col5_data20": {},

"col5_comment20": {},

"col6_data20": {},

"col6_comment20": {},

"col7_data20": {},

"col7_comment20": {},

"col8_data20": {},

"col8_comment20": {},

"col9_data20": {},

"col9_comment20": {},

"col1_data21": {},

"data21": {},

"label21": {},

"col1_comment21": {},

"comment21": {},

"col2_data21": {},

"col2_comment21": {},

"col3_data21": {},

"col3_comment21": {},

"col4_data21": {},

"col4_comment21": {},

"col5_data21": {},

"col5_comment21": {},

"col6_data21": {},

"col6_comment21": {},

"col7_data21": {},

"col7_comment21": {},

"col8_data21": {},

"col8_comment21": {},

"col9_data21": {},

"col9_comment21": {},

"col1_data22": {},

"data22": {},

"label22": {},

"col1_comment22": {},

"comment22": {},

"col2_data22": {},

"col2_comment22": {},

"col3_data22": {},

"col3_comment22": {},

"col4_data22": {},

"col4_comment22": {},

"col5_data22": {},

"col5_comment22": {},

"col6_data22": {},

"col6_comment22": {},

"col7_data22": {},

"col7_comment22": {},

"col8_data22": {},

"col8_comment22": {},

"col9_data22": {},

"col9_comment22": {},

"col1_data23": {},

"data23": {},

"label23": {},

"col1_comment23": {},

"comment23": {},

"col2_data23": {},

"col2_comment23": {},

"col3_data23": {},

"col3_comment23": {},

"col4_data23": {},

"col4_comment23": {},

"col5_data23": {},

"col5_comment23": {},

"col6_data23": {},

"col6_comment23": {},

"col7_data23": {},

"col7_comment23": {},

"col8_data23": {},

"col8_comment23": {},

"col9_data23": {},

"col9_comment23": {},

"col1_data24": {},

"data24": {},

"label24": {},

"col1_comment24": {},

"comment24": {},

"col2_data24": {},

"col2_comment24": {},

"col3_data24": {},

"col3_comment24": {},

"col4_data24": {},

"col4_comment24": {},

"col5_data24": {},

"col5_comment24": {},

"col6_data24": {},

"col6_comment24": {},

"col7_data24": {},

"col7_comment24": {},

"col8_data24": {},

"col8_comment24": {},

"col9_data24": {},

"col9_comment24": {},

"col1_data25": {},

"data25": {},

"label25": {},

"col1_comment25": {},

"comment25": {},

"col2_data25": {},

"col2_comment25": {},

"col3_data25": {},

"col3_comment25": {},

"col4_data25": {},

"col4_comment25": {},

"col5_data25": {},

"col5_comment25": {},

"col6_data25": {},

"col6_comment25": {},

"col7_data25": {},

"col7_comment25": {},

"col8_data25": {},

"col8_comment25": {},

"col9_data25": {},

"col9_comment25": {},

"col1_data26": {},

"data26": {},

"label26": {},

"col1_comment26": {},

"comment26": {},

"col2_data26": {},

"col2_comment26": {},

"col3_data26": {},

"col3_comment26": {},

"col4_data26": {},

"col4_comment26": {},

"col5_data26": {},

"col5_comment26": {},

"col6_data26": {},

"col6_comment26": {},

"col7_data26": {},

"col7_comment26": {},

"col8_data26": {},

"col8_comment26": {},

"col9_data26": {},

"col9_comment26": {},

"col1_data27": {},

"data27": {},

"label27": {},

"col1_comment27": {},

"comment27": {},

"col2_data27": {},

"col2_comment27": {},

"col3_data27": {},

"col3_comment27": {},

"col4_data27": {},

"col4_comment27": {},

"col5_data27": {},

"col5_comment27": {},

"col6_data27": {},

"col6_comment27": {},

"col7_data27": {},

"col7_comment27": {},

"col8_data27": {},

"col8_comment27": {},

"col9_data27": {},

"col9_comment27": {},

"col1_data28": {},

"data28": {},

"label28": {},

"col1_comment28": {},

"comment28": {},

"col2_data28": {},

"col2_comment28": {},

"col3_data28": {},

"col3_comment28": {},

"col4_data28": {},

"col4_comment28": {},

"col5_data28": {},

"col5_comment28": {},

"col6_data28": {},

"col6_comment28": {},

"col7_data28": {},

"col7_comment28": {},

"col8_data28": {},

"col8_comment28": {},

"col9_data28": {},

"col9_comment28": {},

"col1_data29": {},

"data29": {},

"label29": {},

"col1_comment29": {},

"comment29": {},

"col2_data29": {},

"col2_comment29": {},

"col3_data29": {},

"col3_comment29": {},

"col4_data29": {},

"col4_comment29": {},

"col5_data29": {},

"col5_comment29": {},

"col6_data29": {},

"col6_comment29": {},

"col7_data29": {},

"col7_comment29": {},

"col8_data29": {},

"col8_comment29": {},

"col9_data29": {},

"col9_comment29": {},

"col1_data30": {},

"data30": {},

"label30": {},

"col1_comment30": {},

"comment30": {},

"col2_data30": {},

"col2_comment30": {},

"col3_data30": {},

"col3_comment30": {},

"col4_data30": {},

"col4_comment30": {},

"col5_data30": {},

"col5_comment30": {},

"col6_data30": {},

"col6_comment30": {},

"col7_data30": {},

"col7_comment30": {},

"col8_data30": {},

"col8_comment30": {},

"col9_data30": {},

"col9_comment30": {},

"total": {},

"col1_total": {},

"col2_total": {},

"col3_total": {},

"col4_total": {},

"col5_total": {},

"col6_total": {},

"col7_total": {},

"col8_total": {},

"col9_total": {},

"caption": {}

}

Formatted, commented code (as of 22 Jun 2025)

{{#if: {{{width|}}} |

style="width: {{{width|40}}}em;"

}}>

style="width: {{#iferror:

{{#expr: {{{width|40}}} * {{formatnum:{{{1|300000}}}|R}} / {{formatnum:{{{2|600000}}}|R}} round 1}}

| 0

}}em;">

{{#if: {{{width|}}} |

style="width: {{{width}}}em;"

}}>

{{nowrap|

{{formatnum: {{replace|{{{1|300000}}}|,|}}}}

{{#if: {{{comment|}}} |

({{{comment}}})

}}

Template:Bar chart/doc#Empty cells

Usage and parameters

Alignment

Caption

Empty cells

Example

Example with comments

Example with two data columns

Template data

Formatted, commented code (as of 22 Jun 2025)

See also