View source for Template:Chess diagram/doc

{{documentation subpage}}

=== Syntax ===

There are several standard [[chess]] diagram templates:

* [[Template:Chess diagram]] (square size 26x26 px)
* [[Template:Chess diagram small]] (square size 22x22 px)
* [[Template:Chess diagram 4x4]] (square size 26x26 px)
* [[Template:Chess diagram 4x5]] (square size 26x26 px)
* [[Template:Chess diagram 5x5]] (square size 26x26 px)
* [[Template:Chess diagram 5x6]] (square size 26x26 px)
* [[Template:Chess diagram 6x6]] (square size 26x26 px)
* [[Template:Chess diagram 8x10]] ([[Capablanca chess]] square size 26x26 px)
* [[Template:Chess diagram 8x12]] (square size 26x26 px)
* [[Template:Chess diagram 9x9]] (square size 26x26 px)
* [[Template:Chess diagram 10x10]] (square size 26x26 px)
There are also templates for [[chess variant]]s: 
* [[Template:Alice chess diagram]] ([[Alice chess]], square size 22x22 px)
* [[Template:Bughouse chess diagram]] ([[Bughouse chess]], square size 22x22 px)
* [[Template:Omega Chess diagram]] ([[Omega Chess]] with 10x10 board + 4 corners, 22x22 px)
* [[Template:Raumschach diagram]] (5x5x5 board for [[Three-dimensional chess]], 22x22 px)

The syntax is basically the same for all of them.

<pre>
{{Chess diagram
| <alignment> (param #1)
| <header>    (#2) 
| size =
| numbers =
| letters =
| <a8> | <b8> | ... | <h8>  (#3 to ...
| <a7> | <b7> | ... | <h7>
...
| <a1> | <b1> | ... | <h1>  ( ... #66)
| <footer> (#67)
}}
</pre>

Parameters:

* <code><alignment></code> – defines horizontal alignment (floating) of the whole table, must be <code>tright</code> or <code>tleft</code> (or nothing)
* <code><header></code> – the text which appears above the diagram, may be empty;
* <code>size</code> - specifies the size of each square in pixels, the default is 26.
* <code>numbers</code> - specifies whether the rows are numbered. Options are: ''left'', ''right'', ''both'' (default) or ''neither''.
* <code>letters</code> - specifies whether the columns are lettered. Options are: ''top'', ''bottom'', ''both'' (default) or ''neither''.
* <code><a8>, <b8>, ... <nowiki><h1></nowiki></code> – define corresponding squares of the chessboard, see below;
* <code><footer></code> – the text which appears beneath the diagram, may be empty; optional – can be left out (currently not in the other templates)

A square is defined by the name of piece or empty parameter. The names of the pieces are those given in algebraic notation:

* [[Image:Chess kll45.svg|26px]] [[Image:Chess kld45.svg|26px]] [[Image:Chess kdl45.svg|26px]] [[Image:Chess kdd45.svg|26px]] k = king
* [[Image:Chess qld45.svg|26px]] [[Image:Chess qll45.svg|26px]] [[Image:Chess qdd45.svg|26px]] [[Image:Chess qdl45.svg|26px]] q = queen
* [[Image:Chess rll45.svg|26px]] [[Image:Chess rld45.svg|26px]] [[Image:Chess rdl45.svg|26px]] [[Image:Chess rdd45.svg|26px]] r = rook
* [[Image:Chess bld45.svg|26px]] [[Image:Chess bll45.svg|26px]] [[Image:Chess bdd45.svg|26px]] [[Image:Chess bdl45.svg|26px]] b = bishop
* [[Image:Chess nll45.svg|26px]] [[Image:Chess nld45.svg|26px]] [[Image:Chess ndl45.svg|26px]] [[Image:Chess ndd45.svg|26px]] n = knight
* [[Image:Chess pld45.svg|26px]] [[Image:Chess pll45.svg|26px]] [[Image:Chess pdd45.svg|26px]] [[Image:Chess pdl45.svg|26px]] p = pawn

There are also some [[fairy chess piece]]s available:

* [[Image:Chess all45.svg|26px]] [[Image:Chess ald45.svg|26px]] [[Image:Chess adl45.svg|26px]] [[Image:Chess add45.svg|26px]] a = archbishop (knight + bishop compound)
* [[Image:Chess cld45.svg|26px]] [[Image:Chess cll45.svg|26px]] [[Image:Chess cdd45.svg|26px]] [[Image:Chess cdl45.svg|26px]] c = chancellor (knight + rook compound)
* [[Image:Chess fll45.svg|26px]] [[Image:Chess fld45.svg|26px]] [[Image:Chess fdl45.svg|26px]] [[Image:Chess fdd45.svg|26px]] f = upside-down king
* [[Image:Chess gld45.svg|26px]] [[Image:Chess gll45.svg|26px]] [[Image:Chess gdd45.svg|26px]] [[Image:Chess gdl45.svg|26px]] g = upside-down queen
* [[Image:Chess mll45.svg|26px]] [[Image:Chess mld45.svg|26px]] [[Image:Chess mdl45.svg|26px]] [[Image:Chess mdd45.svg|26px]] m = upside-down rook
* [[Image:Chess eld45.svg|26px]] [[Image:Chess ell45.svg|26px]] [[Image:Chess edd45.svg|26px]] [[Image:Chess edl45.svg|26px]] e = upside-down bishop
* [[Image:Chess sll45.svg|26px]] [[Image:Chess sld45.svg|26px]] [[Image:Chess sdl45.svg|26px]] [[Image:Chess sdd45.svg|26px]] N = upside-down knight
* [[Image:Chess hld45.svg|26px]] [[Image:Chess hll45.svg|26px]] [[Image:Chess hdd45.svg|26px]] [[Image:Chess hdl45.svg|26px]] h = upside-down pawn
* [[Image:Chess zll45.svg|26px]] [[Image:Chess zld45.svg|26px]] [[Image:Chess zdl45.svg|26px]] [[Image:Chess zdd45.svg|26px]] z = champion (for Omega Chess)
* [[Image:Chess wld45.svg|26px]] [[Image:Chess wll45.svg|26px]] [[Image:Chess wdd45.svg|26px]] [[Image:Chess wdl45.svg|26px]] w = wizard (for Omega Chess)
* [[Image:Chess tld45.svg|26px]] [[Image:Chess tll45.svg|26px]] [[Image:Chess tdd45.svg|26px]] [[Image:Chess tdl45.svg|26px]] t = fool (for Omega Chess)

These letters are combined with either "l" for Light=White, or "d" for Dark=Black. So "kl" is White's king, and "nd" is Black's knight. 

An empty square is written either using underscores, spaces, or nothing at all. Two spaces are recommended.

* [[Image:Chess d45.svg|26px]][[Image:Chess l45.svg|26px]] <space> = empty square

You can also use "xx" for a black cross, "ox" for a white cross, "xo" for a black circle on an empty square or "oo" for a white one.

* [[Image:Chess xxd45.svg|26px]][[Image:Chess xxl45.svg|26px]] xx = black cross/x
* [[Image:Chess oxd45.svg|26px]][[Image:Chess oxl45.svg|26px]] ox = white cross/x 
* [[Image:Chess xod45.svg|26px]][[Image:Chess xol45.svg|26px]] xo = black circle
* [[Image:Chess ood45.svg|26px]][[Image:Chess ool45.svg|26px]] oo = white circle

When showing movement directions on the board, arrows are available

* [[Image:Chess uld45.svg|26px]][[Image:Chess ull45.svg|26px]] ul = up & left
* [[Image:Chess uad45.svg|26px]][[Image:Chess ual45.svg|26px]] ua = up
* [[Image:Chess urd45.svg|26px]][[Image:Chess url45.svg|26px]] ur = up & right
* [[Image:Chess lad45.svg|26px]][[Image:Chess lal45.svg|26px]] la = left
* [[Image:Chess lrd45.svg|26px]][[Image:Chess lrl45.svg|26px]] lr = left & right
* [[Image:Chess udd45.svg|26px]][[Image:Chess udl45.svg|26px]] ud = up & down
* [[Image:Chess rad45.svg|26px]][[Image:Chess ral45.svg|26px]] ra = right
* [[Image:Chess dld45.svg|26px]][[Image:Chess dll45.svg|26px]] dl = down & left
* [[Image:Chess dad45.svg|26px]][[Image:Chess dal45.svg|26px]] da = down
* [[Image:Chess drd45.svg|26px]][[Image:Chess drl45.svg|26px]] dr = down & right

Numbers can also be added to squares by using "x0" for 0, "x1" for 1, "x2" for 2, ..., "x9" for 9. 

* [[Image:Chess x0d45.svg|26px]][[Image:Chess x0l45.svg|26px]] x0
* [[Image:Chess x1d45.svg|26px]][[Image:Chess x1l45.svg|26px]] x1
* [[Image:Chess x2d45.svg|26px]][[Image:Chess x2l45.svg|26px]] x2
* [[Image:Chess x3d45.svg|26px]][[Image:Chess x3l45.svg|26px]] x3
* [[Image:Chess x4d45.svg|26px]][[Image:Chess x4l45.svg|26px]] x4
* [[Image:Chess x5d45.svg|26px]][[Image:Chess x5l45.svg|26px]] x5
* [[Image:Chess x6d45.svg|26px]][[Image:Chess x6l45.svg|26px]] x6
* [[Image:Chess x7d45.svg|26px]][[Image:Chess x7l45.svg|26px]] x7
* [[Image:Chess x8d45.svg|26px]][[Image:Chess x8l45.svg|26px]] x8
* [[Image:Chess x9d45.svg|26px]][[Image:Chess x9l45.svg|26px]] x9

=== Examples ===

In the following examples the rows and columns are numbered. Because any text between "|=" and the next "|" is ignored, numbers and letters can be added without affecting output.

==== Standard diagram ====

This diagram is recommended for common use as a main diagram in the articles on chess openings, endings, games, positions etc. See the corresponding code below.

{{Chess diagram
| tright
| 
|= 

 8 |rd|nd|bd|qd|kd|bd|nd|rd|=
 7 |pd|pd|pd|pd|  |pd|pd|pd|=
 6 |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |pd|  |  |  |=
 4 |  |  |  |  |pl|pl|  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|  |  |pl|pl|=
 1 |rl|nl|bl|ql|kl|bl|nl|rl|=
    a  b  c  d  e  f  g  h

| The King's Gambit
}}

<pre style="margin-right:280px;">
{{Chess diagram
| tright
| 
|= 

 8 |rd|nd|bd|qd|kd|bd|nd|rd|=
 7 |pd|pd|pd|pd|  |pd|pd|pd|=
 6 |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |pd|  |  |  |=
 4 |  |  |  |  |pl|pl|  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|  |  |pl|pl|=
 1 |rl|nl|bl|ql|kl|bl|nl|rl|=
    a  b  c  d  e  f  g  h  

| The King's Gambit
}}
</pre>

==== Diagram with both captions ====

{{Chess diagram
| tright
| '''W. Langstaff''', ''Chess Amateur'' 1922
|= 

 8 |  |  |  |  |kd|  |  |rd|=
 7 |  |  |  |  |  |  |  |  |=
 6 |  |  |  |  |  |bl|  |pl|=
 5 |  |  |  |rl|  |kl|pd|pl|=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |  |  |  |  |  |  |  |  |=
 1 |  |  |  |  |  |  |  |  |=
    a  b  c  d  e  f  g  h  

| '''Mate in two.''' <br> This problem uses ''partial retrograde analysis'' method.
}}

It may be convenient to use this in the articles on chess problems. Please note that in the header and footer you can use '''bolds''' or ''italics''. You can also use <code>&lt;br></code> to break the lines.

<pre style="overflow:auto">
{{Chess diagram
| tright
| '''W. Langstaff''', ''Chess Amateur'' 1922
|= 

 8 |  |  |  |  |kd|  |  |rd|=
 7 |  |  |  |  |  |  |  |  |=
 6 |  |  |  |  |  |bl|  |pl|=
 5 |  |  |  |rl|  |kl|pd|pl|=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |  |  |  |  |  |  |  |  |=
 1 |  |  |  |  |  |  |  |  |=
    a  b  c  d  e  f  g  h  

| '''Mate in two.''' <br> This problem uses ''partial retrograde analysis'' method.
}}
</pre>

==== Diagram without captions ====

{{Chess diagram
| tleft
| 
|= 

 8 |  |  |  |  |  |  |  |  |=
 7 |  |  |  |  |  |  |  |  |=
 6 |  |xx|xo|xx|  |  |  |  |=
 5 |  |  |pl|  |  |  |  |  |=
 4 |  |  |  |  |  |xo|  |  |=
 3 |  |  |  |  |xx|xo|xx|  |=
 2 |  |  |  |  |  |pl|  |  |=
 1 |  |  |  |  |  |  |  |  |=
    a  b  c  d  e  f  g  h
}}

See the corresponding code below. If you don't want the captions, just remove them, but don't delete the second "|" pipe character for the caption above; it is possible to delete the last pipe for the longer caption below.

The diagram floats to the left to illustrate the use of the first parameter.

<pre style="margin-left:280px;">
{{Chess diagram
| tleft
| 
|= 

 8 |  |  |  |  |  |  |  |  |=
 7 |  |  |  |  |  |  |  |  |=
 6 |  |xx|xo|xx|  |  |  |  |=
 5 |  |  |pl|  |  |  |  |  |=
 4 |  |  |  |  |  |xo|  |  |=
 3 |  |  |  |  |xx|xo|xx|  |=
 2 |  |  |  |  |  |pl|  |  |=
 1 |  |  |  |  |  |  |  |  |=
    a  b  c  d  e  f  g  h  
}}
</pre>

==== Movement Example ====
This can be used to show how pieces move.
{{Chess diagram
| tleft
| 
|= 

 8 |  |  |ua|  |  |  |  |  |=
 7 |  |  |ua|  |  |  |  |  |=
 6 |la|la|rd|ra|ra|ra|ra|ra|=
 5 |  |  |da|  |  |  |  |  |=
 4 |  |  |da|  |ul|ua|ur|  |=
 3 |  |  |da|  |la|kl|ra|  |=
 2 |  |  |da|  |dl|da|dr|  |=
 1 |  |  |da|  |  |  |  |  |=
    a  b  c  d  e  f  g  h

|Example showing how white king can move
any direction, but only one square, while
black rook can move any number of squares
but only up and down, and right and left.
}}
<pre style="margin-left:280px;">
{{Chess diagram
| tleft
| 
|= 

 8 |  |  |ua|  |  |  |  |  |=
 7 |  |  |ua|  |  |  |  |  |=
 6 |la|la|rd|ra|ra|ra|ra|ra|=
 5 |  |  |da|  |  |  |  |  |=
 4 |  |  |da|  |ul|ua|ur|  |=
 3 |  |  |da|  |la|kl|ra|  |=
 2 |  |  |da|  |dl|da|dr|  |=
 1 |  |  |da|  |  |  |  |  |=
    a  b  c  d  e  f  g  h

|Example showing how white king can move
any direction, but only one square, while
black rook can move any number of squares
but only up and down, and right and left.
}}
</pre>
{{clear}}
{{Chess diagram
| tright
| 
|= 

 8 |  |ul|  |ua|  |ur|  |  |=
 7 |  |  |ul|ua|ur|  |  |  |=
 6 |la|la|la|ql|ra|ra|ra|ra|=
 5 |  |  |dl|da|dr|  |  |  |=
 4 |  |dl|  |da|  |dr|  |  |=
 3 |dl|  |  |da|  |  |dr|  |=
 2 |  |  |  |da|  |  |  |dr|=
 1 |  |  |  |da|  |  |  |  |=
    a  b  c  d  e  f  g  h
}}
<pre>
{{Chess diagram
| tright
| 
|= 

 8 |  |ul|  |ua|  |ur|  |  |=
 7 |  |  |ul|ua|ur|  |  |  |=
 6 |la|la|la|ql|ra|ra|ra|ra|=
 5 |  |  |dl|da|dr|  |  |  |=
 4 |  |dl|  |da|  |dr|  |  |=
 3 |dl|  |  |da|  |  |dr|  |=
 2 |  |  |  |da|  |  |  |dr|=
 1 |  |  |  |da|  |  |  |  |=
    a  b  c  d  e  f  g  h
}}
</pre>
In the board on the right, it is shown that the white queen can go any distance in any of these directions.
{{clear}}
Another method for the rook example:
{{Chess diagram
| tleft
| 
|= 

 8 |  |  |  |  |  |  |  |  |=
 7 |  |  |ud|  |  |  |  |  |=
 6 |  |lr|rd|lr|  |  |  |  |=
 5 |  |  |ud|  |  |  |  |  |=
 4 |  |  |  |  |ul|ua|ur|  |=
 3 |  |  |  |  |la|kl|ra|  |=
 2 |  |  |  |  |dl|da|dr|  |=
 1 |  |  |  |  |  |  |  |  |=
    a  b  c  d  e  f  g  h
}}
<pre style="margin-left:280px;">
{{Chess diagram
| tleft
| 
|= 

 8 |  |  |  |  |  |  |  |  |=
 7 |  |  |ud|  |  |  |  |  |=
 6 |  |lr|rd|lr|  |  |  |  |=
 5 |  |  |ud|  |  |  |  |  |=
 4 |  |  |  |  |ul|ua|ur|  |=
 3 |  |  |  |  |la|kl|ra|  |=
 2 |  |  |  |  |dl|da|dr|  |=
 1 |  |  |  |  |  |  |  |  |=
    a  b  c  d  e  f  g  h
}}
</pre>
{{clear}}

==== Small diagram ====

This one may be useful in articles with many diagrams. It uses another template named {{tl|Chess diagram small}}.

The small diagrams can have header, too.

{{Chess diagram small
| tright
| 
|= 

 8 |rd|  |  |qd|  |rd|kd|  |=
 7 |pd|pd|  |  |pd|pd|bd|pd|=
 6 |  |nd|pd|  |  |nd|pd|  |=
 5 |  |  |ql|  |  |  |bl|  |=
 4 |  |  |  |pl|pl|  |bd|  |=
 3 |  |  |nl|  |  |nl|  |  |=
 2 |pl|pl|  |  |  |pl|pl|pl|=
 1 |  |  |  |rl|kl|bl|  |rl|=
    a  b  c  d  e  f  g  h  

| Position after 11.Bg5
}}

<pre>
{{Chess diagram small
| tright
| 
|= 

 8 |rd|  |  |qd|  |rd|kd|  |=
 7 |pd|pd|  |  |pd|pd|bd|pd|=
 6 |  |nd|pd|  |  |nd|pd|  |=
 5 |  |  |ql|  |  |  |bl|  |=
 4 |  |  |  |pl|pl|  |bd|  |=
 3 |  |  |nl|  |  |nl|  |  |=
 2 |pl|pl|  |  |  |pl|pl|pl|=
 1 |  |  |  |rl|kl|bl|  |rl|=
    a  b  c  d  e  f  g  h  

| Position after 11.Bg5
}}
</pre>

==== Different board size ====

Chess boards of non-standard dimensions need special templates. There are templates for
the following boards:

{|
|+ [[Minichess]] (5×5) – [[Template:Chess diagram 5x5]]
|-
| <pre>
{{Chess diagram 5x5
| tright
| 
|= 

 5 |kd|qd|bd|nd|rd|=
 4 |pd|pd|pd|pd|pd|=
 3 |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|=
 1 |kl|ql|bl|nl|rl|=
    a  b  c  d  e  

| Gardner minichess
}}
</pre>
|
{{Chess diagram 5x5
| tright
| 
|= 

 5 |kd|qd|bd|nd|rd|=
 4 |pd|pd|pd|pd|pd|=
 3 |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|=
 1 |kl|ql|bl|nl|rl|=
    a  b  c  d  e  

|Gardner minichess
}}
|}

{|
|+ [[Los Alamos chess]] (6×6) – [[Template:Chess diagram 6x6]]
|-
| <pre>
{{Chess diagram 6x6
| tright
| 
|= 

 6 |rd|nd|qd|kd|nd|rd|=
 5 |pd|pd|pd|pd|pd|pd|=
 4 |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|pl|=
 1 |rl|nl|ql|kl|nl|rl|=
    a  b  c  d  e  f  

| Los Alamos chess
}}
</pre>
|
{{Chess diagram 6x6
| tright
| 
|= 

 6 |rd|nd|qd|kd|nd|rd|=
 5 |pd|pd|pd|pd|pd|pd|=
 4 |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|pl|=
 1 |rl|nl|ql|kl|nl|rl|=
    a  b  c  d  e  f  

| Los Alamos chess
}}
|}

{|
|+ [[Capablanca chess]] (8×10)
|-
| <pre>
{{Chess diagram 8x10
| tright
| 
|= 

 8 |rd|nd|ad|bd|qd|kd|bd|cd|nd|rd|=
 7 |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd|=
 6 |  |  |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |  |  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl|=
 1 |rl|nl|al|bl|ql|kl|bl|cl|nl|rl|=
    a  b  c  d  e  f  g  h  i  j

| Capablanca chess
}}
</pre>
|
{{Chess diagram 8x10
| tright
| 
|= 

 8 |rd|nd|ad|bd|qd|kd|bd|cd|nd|rd|=
 7 |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd|=
 6 |  |  |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |  |  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl|=
 1 |rl|nl|al|bl|ql|kl|bl|cl|nl|rl|=
    a  b  c  d  e  f  g  h  i  j

| Capablanca chess
}}
|}

{|
|+ [[Grand Chess]]
|-
| <pre>
{{Chess diagram 10x10
| tright
| 
|= 

10 |rd|  |  |  |  |  |  |  |  |rd|=
 9 |  |nd|bd|qd|kd|cd|ad|bd|nd|  |=
 8 |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd|=
 7 |  |  |  |  |  |  |  |  |  |  |=
 6 |  |  |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |  |  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |  |  |=
 3 |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl|=
 2 |  |nl|bl|ql|kl|cl|al|bl|nl|  |=
 1 |rl|  |  |  |  |  |  |  |  |rl|=
    a  b  c  d  e  f  g  h  i  j

| Grand Chess
}}
</pre>
| {{Chess diagram 10x10
| tright
| 
|= 

10 |rd|  |  |  |  |  |  |  |  |rd|=
 9 |  |nd|bd|qd|kd|cd|ad|bd|nd|  |=
 8 |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd|=
 7 |  |  |  |  |  |  |  |  |  |  |=
 6 |  |  |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |  |  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |  |  |=
 3 |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl|=
 2 |  |nl|bl|ql|kl|cl|al|bl|nl|  |=
 1 |rl|  |  |  |  |  |  |  |  |rl|=
    a  b  c  d  e  f  g  h  i  j

| Grand Chess
}}
|}

==== Double boards ====

{|
|+ [[Bughouse chess]] (four players)
|- style="vertical-align: top;"
| <pre style="margin-right:1em">
{{bughouse chess diagram
| A1=Team 1, Board A 
| A2=Team 2, Board A 
| B1=Team 1, Board B 
| B2=Team 2, Board B
| tright
|
|=
 8 |rd|nd|bd|qd|kd|bd|nd|rd|=
 7 |pd|pd|pd|pd|pd|pd|pd|pd|=
 6 |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|pl|pl|pl|=
 1 |rl|nl|bl|ql|kl|bl|nl|rl|=
    a  b  c  d  e  f  g  h

 8 |rl|nl|bl|kl|ql|bl|nl|rl|=
 7 |pl|pl|pl|pl|pl|pl|pl|pl|=
 6 |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |pd|pd|pd|pd|pd|pd|pd|pd|=
 1 |rd|nd|bd|kd|qd|bd|nd|rd|=
    a  b  c  d  e  f  g  h

| '''Bughouse''' setup and starting position
}}
</pre>
|
{{bughouse chess diagram
| A1=Team 1, Board A 
| A2=Team 2, Board A 
| B1=Team 1, Board B 
| B2=Team 2, Board B
|
|
|=
 8 |rd|nd|bd|qd|kd|bd|nd|rd|=
 7 |pd|pd|pd|pd|pd|pd|pd|pd|=
 6 |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|pl|pl|pl|=
 1 |rl|nl|bl|ql|kl|bl|nl|rl|=
    a  b  c  d  e  f  g  h

 8 |rl|nl|bl|kl|ql|bl|nl|rl|=
 7 |pl|pl|pl|pl|pl|pl|pl|pl|=
 6 |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |pd|pd|pd|pd|pd|pd|pd|pd|=
 1 |rd|nd|bd|kd|qd|bd|nd|rd|=
    a  b  c  d  e  f  g  h

| '''Bughouse''' setup and starting position}}
|}

{|
|+ [[Alice chess]] (two players)
|- style="vertical-align: top;"
| <pre style="margin-right:1em; padding-right:0">
{{alice chess diagram
| tright
|
|=
 8 |rd|nd|bd|qd|kd|  |nd|rd|=
 7 |pd|pd|pd|pd|  |pd|pd|pd|=
 6 |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |nl|  |  |  |=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|pl|pl|pl|=
 1 |rl|nl|bl|ql|kl|bl|  |rl|=
    a  b  c  d  e  f  g  h
          Board A

 8 |  |  |  |  |  |  |  |  |=
 7 |  |  |  |  |  |  |  |  |=
 6 |  |  |  |  |pd|  |  |  |=
 5 |  |  |bd|  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |  |  |  |  |  |  |  |  |=
 1 |  |  |  |  |  |  |  |  |=
    a  b  c  d  e  f  g  h
          Board B
| Position after '''1. Nf3 e6 2. Ne5 Bc5'''
}}

</pre>
|
{{alice chess diagram
|
|
|=
 8 |rd|nd|bd|qd|kd|  |nd|rd|=
 7 |pd|pd|pd|pd|  |pd|pd|pd|=
 6 |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |nl|  |  |  |=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|pl|pl|pl|=
 1 |rl|nl|bl|ql|kl|bl|  |rl|=
    a  b  c  d  e  f  g  h
          Board A

 8 |  |  |  |  |  |  |  |  |=
 7 |  |  |  |  |  |  |  |  |=
 6 |  |  |  |  |pd|  |  |  |=
 5 |  |  |bd|  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |  |  |  |  |  |  |  |  |=
 1 |  |  |  |  |  |  |  |  |=
    a  b  c  d  e  f  g  h
          Board B
| Position after '''1. Nf3 e6 2. Ne5 Bc5'''
}}
|}

==== Different shaped board ====

{|
|+ [[Three-dimensional chess]] (Raumschach) – [[Template:Raumschach diagram]]
|- style="vertical-align: top;"
| <pre>
{{Raumschach diagram
| tright
|
|=
5 |rd|nd|kd|nd|rd|=
4 |pd|pd|pd|pd|pd|=
3 |  |  |  |  |  |=
2 |  |  |  |  |  |=
1 |  |  |  |  |  |=
   Ea Eb Ec Ed Ee

5 |Nd|bd|qd|Nd|bd|=
4 |pd|pd|pd|pd|pd|=
3 |  |  |  |  |  |=
2 |  |  |  |  |  |=
1 |  |  |  |  |  |=
   Da Db Dc Dd De

5 |  |  |  |  |  |=
4 |  |  |  |  |  |=
3 |  |  |  |  |  |=
2 |  |  |  |  |  |=
1 |  |  |  |  |  |=
   Ca Cb Cc Cd Ce

5 |  |  |  |  |  |=
4 |  |  |  |  |  |=
3 |  |  |  |  |  |=
2 |pl|pl|pl|pl|pl|=
1 |bl|Nl|ql|bl|Nl|=
   Ba Bb Bc Bd Be

5 |  |  |  |  |  |=
4 |  |  |  |  |  |=
3 |  |  |  |  |  |=
2 |pl|pl|pl|pl|pl|=
1 |rl|nl|kl|nl|rl|=
   Aa Ab Ac Ad Ae

| '''Raumschach''' starting position
}}
</pre>
|
{{Raumschach diagram
| tright
|
|=
5 |rd|nd|kd|nd|rd|=
4 |pd|pd|pd|pd|pd|=
3 |  |  |  |  |  |=
2 |  |  |  |  |  |=
1 |  |  |  |  |  |=
   Ea Eb Ec Ed Ee

5 |Nd|bd|qd|Nd|bd|=
4 |pd|pd|pd|pd|pd|=
3 |  |  |  |  |  |=
2 |  |  |  |  |  |=
1 |  |  |  |  |  |=
   Da Db Dc Dd De

5 |  |  |  |  |  |=
4 |  |  |  |  |  |=
3 |  |  |  |  |  |=
2 |  |  |  |  |  |=
1 |  |  |  |  |  |=
   Ca Cb Cc Cd Ce

5 |  |  |  |  |  |=
4 |  |  |  |  |  |=
3 |  |  |  |  |  |=
2 |pl|pl|pl|pl|pl|=
1 |bl|Nl|ql|bl|Nl|=
   Ba Bb Bc Bd Be

5 |  |  |  |  |  |=
4 |  |  |  |  |  |=
3 |  |  |  |  |  |=
2 |pl|pl|pl|pl|pl|=
1 |rl|nl|kl|nl|rl|=
   Aa Ab Ac Ad Ae

| '''Raumschach''' starting position
}}
|}

{|
|+ [[Omega Chess]] – [[Template:Omega Chess diagram]]
|-
| <pre style="padding-right:1ex; margin-right:1em">
{{Omega Chess diagram
|
| [[Omega Chess]] (10x10 + 4 corners)
|=
  w4                                   w3
   |wd|=                            |wd|=
    9 |zd|rd|nd|bd|qd|kd|bd|nd|rd|zd|=
    8 |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd|=
    7 |  |  |  |  |  |  |  |  |  |  |=
    6 |  |  |  |  |  |  |  |  |  |  |=
    5 |  |  |  |  |  |  |  |  |  |  |=
    4 |  |  |  |  |  |  |  |  |  |  |=
    3 |  |  |  |  |  |  |  |  |  |  |=
    2 |  |  |  |  |  |  |  |  |  |  |=
    1 |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl|=
    0 |zl|rl|nl|bl|ql|kl|bl|nl|rl|zl|=
   |wl|=                            |wl|=
  w1    a  b  c  d  e  f  g  h  i  j   w2

| '''Omega Chess''' starting position
}}
</pre>
| {{Omega Chess diagram
|
| [[Omega Chess]] (10x10 + 4 corners)
|=
  w4                                   w3
   |wd|=                            |wd|=
    9 |zd|rd|nd|bd|qd|kd|bd|nd|rd|zd|=
    8 |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd|=
    7 |  |  |  |  |  |  |  |  |  |  |=
    6 |  |  |  |  |  |  |  |  |  |  |=
    5 |  |  |  |  |  |  |  |  |  |  |=
    4 |  |  |  |  |  |  |  |  |  |  |=
    3 |  |  |  |  |  |  |  |  |  |  |=
    2 |  |  |  |  |  |  |  |  |  |  |=
    1 |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl|=
    0 |zl|rl|nl|bl|ql|kl|bl|nl|rl|zl|=
   |wl|=                            |wl|=
  w1    a  b  c  d  e  f  g  h  i  j   w2

| '''Omega Chess''' starting position
}}
|}

==Alternative way to place the pieces: FEN==
<pre>
{{Chess diagram|fen=rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR|align=tleft}}
</pre>
{{Chess diagram|fen=rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR|align=tleft}}
It is possible to populate the boardd using [[Forsyth–Edwards Notation]], instead of positional parameters. 

To do this, the "fen" parameter is used. For instance, this is the opening board of a chess game, defined using the "fen" parameter "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR":
{{-}}
<pre>
{{Chess diagram|fen=rnbqkbnr/acfghzwt/8/8/8/8/ACFGHZWT/RNBQKBNR|align=tleft}}
</pre>
{{Chess diagram|fen=rnbqkbnr/acfghzwt/8/8/8/8/ACFGHZWT/RNBQKBNR|align=tleft}}
It is also possible to show "fairy" pieces usign the FEN notation. However, because the FEN notation uses upercase and lowercase to denote the color of the piece, it is not possible to display the upside-down knight fairy piece (denoted by "N") using the fen parameter. Here is a board where the pawns are replaced by fairy pieces:
{{-}}
Only 8x8 boards can use the "fen" parameter. for other size board, positional paramters should be used.
== Displaying the board from the black's point of view ==
<pre>
{{Chess diagram|reverse=true}}
</pre>
{{Chess diagram|reverse=true}}
8x8 boards can be shown from black's point of view, i.e., with h8 square at lower left corner and a1 at the upper right. This is done by using "reverse=true" parameter.
{{-}}
==See also==
*[[Template:Chess position]], alternative template no longer in use

<includeonly>{{#ifeq:{{PAGENAME}}|{{BASEPAGENAME}}|
[[Category:Chess diagram templates|Chess diagram]]
}}</includeonly>