Template {{Chembox}} is an infobox for chemicals. It has a large number of options to add relevant data and images. The infobox is organized in sections like "identifiers" and "hazards".
The Chembox has a modular design. After the general information like the chemical name and images, it can be built from multiple sections, each covering a group of information (like "pharmacology"). Depending on the compound, sections can be added or left out, and within a section parameters can be added or omitted (left blank).
The sections and their parameters are listed below.
Within the general chembox template (with its own parameters like |ImageFile= and |IUPACName=), each section is added with this pattern (as the value of a parameter |Sectionx=.
{{Chembox| ImageFile = | IUPACName = <!-- more general Chembox parameters here -->| Section1 = {{Chembox Identifiers| CASNo = | PubChem = <!-- more Identifier parameters here --> }}}}
In this format, spaces and new lines have no meaning and can be used freely to separate sections (though within a data value, a space has a meaning, except generally leading and trailing spaces).Each section has its own number in |Section#=. Then a section is defined with "|Section# = {{Chembox " and ends with "}}". Sections cannot 'nest': one must close one section with }} before adding another |Section#= {{Chembox ....
Keep in mind the advice in the main Infobox documentation to use the {{Unbulleted list}} template to present multiple values for a parameter so as to ensure that the values are each started on a new line and tagged appropriately in the underlying markup. This is particularly important with parameters like |OtherNames=, since many names use commas within them, and using commas as separators leads to ambiguity. For example:
.Reference, use <ref>...</ref> and add to the pageTitle (default: article name)IUPAC nameThe preferred nameThe systematic name(s)Any other name(s) . . . . .A non-default data page name (default, eg for ammonia: "[[Ammonia (data page)]]")Like filename.svg (not [[file:filename.svg]])Picture width (default=220px; example: ImageSize=100px)Alt text for picture (example: Fine dry white powder)Image link titlePicture caption (example: Oxygen in liquid form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .{{Chembox Identifiers}}Any abbreviationsCAS Number, links to eMoleculesChEBI, links to EBIEINECS, links to ecb; URL is http://ecb.jrc.it/esis/index.php?GENRE=ECNO&ENTREE=EINECS, links to ecb, different URL http://ecb.jrc.it/esis/index.php?GENRE=CASNO&ENTREE=InChI, no linkKEGG, links to genome.ad.jpMedical Subject Headings, links to NIHPubChem, links to pubchemRTECS, no linkSMILES, no link {{Chembox Properties}}: physical propertiesAtmospheric OH rate constantIts appearanceBoiling point description; optional. E.g. "Decomposes at"Temperature, number only. Can be a range: '100 to 200'
Notes on boiling pointDensity, including unitThe molecular formulaHenry's law constant (kH)Partition coefficientMolecular weight, including unitMelting point description; optional. E.g. "Decomposes at"Temperature, number only. Can be a range: '100 to 200'
Notes on melting pointpKapKbSolubility in waterSolubility in other solvents, goes together with nextIn which solvent it is solubleVapor pressure{{Chembox Structure}}: crystal structureCoordinationCrystal structureMolecular shape{{Chembox Thermochemistry}}Delta GfDelta HcDelta HfEntropyHeat capacity{{Chembox Explosive}}Shock sensitivityFriction sensitivityExplosive velocityRelative effectiveness factor{{Chembox Pharmacology}}: drug dataATCvet=yes if the next two parameters define an ATCvet codeATCCode prefix (first three characters, omit the leading Q for ATCvet codes), internal linkATCCode suffix (last 4 characters), full ATC links to WHO C.C.Other ATC codes (use the {{ATC}} and/or {{ATCvet}} templates)Admin RoutesBioavailabilityExcretionHalf LifeMetabolismLegal statusLegal status in AULegal status in CALegal status in NZLegal status in USLegal status in UKLegal status in EULegal status in UNPregnancy CategoryPregnancy Category in AUProtein Bound{{Chembox Hazards}}Autoignition temperatureExplosion limitsFlash pointLD50LC50Main hazardsNFPA-H: Health hazard 0–4 (blue)NFPA-F: Fire hazard 0–4 (red)NFPA-I: Instability (reactivity) hazard 0–4 (yellow) (NFPA-R also allowed)NFPA-S: Special hazards (aka Other; white): W, OX, COR, ALK, ACID, CRYO, RAPELURL for Safety data sheetHPhrases: use the {{H-phrases}} template for thisPPhrases: use the {{P-phrases}} template for this{{Chembox Related}}: related substancesOther anionsOther cationsOther compounds with a given function The given function Other compounds: adds a chemical 'see also' section
Full form
To use, simply copy and paste the left column into the document, and press save to get an empty Chembox:
Then |_Other= (like |CASNoOther=) is available for free text input.
same substance, same index
When the chembox has multiple substances, you can use the index. Make sure that |CASNo3= and |SMILES3= are about the same substance, and |CASNo3= and |SMILES2= are not. Treat index "0" the same way:
|CASNo= is |InChI= is |SMILES=
|CASNo1= is |InChI1= is |SMILES1=
|CASNo= is not|InChI1= is not|SMILES4=
Labeling the substances
By using a parameter like |index2_label=, you can prefix every #2-input with that same prefix.
Use of the |CASNo_Ref={{cascite|correct|CAS}} parameter with argument places a small, green check mark, Y , after the CAS No., which indicates that an editor has confirmed that the CAS No. is correct. A red x in an infobox that follows any identifier means it has not been verified. See WP:CHEMVAL for more details.
See these subsections for their parameter options.
The order of these sections in the infobox is set by the section number (|Section#=) only. Not by the typed sequence. This documentation keeps this arbitrary order:
Sections that are not used can be safely removed, renumbering is not necessary.
Container only
{{Chembox}} can be used to show a subsection only, for example Section3={{Chembox Hazards|...}}. When set |container_only=yes: The main {{Chembox}} is not tracked at all (image checks, bot validation categories, etc.), and the Footer (with STP notice) is suppressed. Example: Bromine#Biological role and toxicity. The article will be listed in ප්රවර්ගය:Chembox container only (0).
Automatic generation
The Wikipedia Drugbox and Chembox Maker can be used to automatically generate chembox templates. For quicker access, this tool can be added to the tools section of Wikipedia's left sidebar via User:Qwerfjkl/scripts/chemboxmaker. The Wikipedia template filling tool by Diberri and Boghog is another option for automatic chembox generation but fills fewer fields.
Adding images
Parameters
Image parameters for the first images:
{{Chembox<!-- Other chembox parameters can go here --><!-- Row 1/7 -->|ImageFile=|ImageName=|ImageSize=|ImageAlt=|ImageCaption=|ImageFile_Ref=<!-- Row 2/7 -->|ImageFile1=|ImageName1=|ImageSize1=|ImageAlt1=|ImageCaption1=|ImageFile1_Ref=<!-- Row 3/7 -->|ImageFileL1=|ImageNameL1=|ImageSizeL1=|ImageAltL1=|ImageCaptionL1=|ImageFileL1_Ref=|ImageFileR1=|ImageNameR1=|ImageSizeR1=|ImageAltR1=|ImageCaptionR1=|ImageFileR1_Ref=|ImageCaptionL1R1=<!-- More chembox parameters can go here, like |Section1=... -->}}
Examples
Image parameters for an image (example: File1). All are optional.
Chembox
A caption shows here
Except where otherwise noted, data are given for materials in their standard state (at 25 °C [77 °F], 100 kPa).
Chemical compoundසැකිල්ල:SHORTDESC:Chemical compound
{{Chembox| ImageFile1 = Furfural.svg| ImageAlt1 = Skeleton formula of a ring of four carbons and one oxygen, with a carbon-oxygen attached to a carbon next to an oxygen| ImageName1 = | ImageCaption1 = A caption shows here| ImageSize1 = | ImageFile1_Ref = ref}}
Adding two images:
Chembox
Except where otherwise noted, data are given for materials in their standard state (at 25 °C [77 °F], 100 kPa).
Chemical compoundසැකිල්ල:SHORTDESC:Chemical compound
{{Chembox| ImageFile = Furfural.svg| ImageAlt = Skeleton formula of a ring of four carbons and one oxygen, with a carbon-oxygen attached to a carbon next to an oxygen| ImageFile1 = Furfural-3D-vdW.png| ImageAlt1 = 3D filled-sphere model of the same molecule}}
This gives two images, each image on his own row (note, ImageFile is the first image, ImageFile1 is the second).
Adding two images, side by side (L1 and R1):
Chembox
Except where otherwise noted, data are given for materials in their standard state (at 25 °C [77 °F], 100 kPa).
Chemical compoundසැකිල්ල:SHORTDESC:Chemical compound
{{Chembox| ImageFileL1 = Furfural.svg| ImageAltL1 = Skeleton formula of a ring of four carbons and one oxygen, with a carbon-oxygen attached to a carbon next to an oxygen| ImageFileR1 = Furfural-3D-vdW.png| ImageAltR1 = 3D filled-sphere model of the same molecule}}
This gives one row with two images. Note that ImageFile is now not supplied.
Multiple images
Chembox image ordering ( v • [{{fullurl:Template:{{{template}}}|action=edit}} edit] )
row 1
ImageFile
row 2
ImageFile1
row 3
ImageFileL1
ImageFileR1
row 4
ImageFile2
row 5
ImageFileL2
ImageFileR2
row 6
ImageFile3
row 7
ImageFileL3
ImageFileR3
This gives the possibility to play a bit with which image is first (rows with empty parameters are not displayed). Example:
Chemical compoundසැකිල්ල:SHORTDESC:Chemical compound
{{Chembox| ImageFileL1 = Furfural.svg| ImageAltL1 = Skeleton formula of a ring of four carbons and one oxygen, with a carbon-oxygen attached to a carbon next to an oxygen| ImageFileR1 = Furfural-3D-vdW.png| ImageSizeR1 = | ImageAltR1 = 3D filled-sphere model of the same molecule| ImageFile2 = Water droplet blue bg05.jpg| ImageAlt2 = Water droplet erupting from the center of a concentric ring of ripples, evidently in response to a drop landing in the water just before| IUPACName = example}}
This gives one row with two images, and one row with one image.
An infobox for chemicals. It has a large number of options to add relevant data and images. The Chembox has a modular design. After the general information like the chemical name and images, it can be built from multiple sections, each covering a group of information (like "pharmacology"). Depending on the compound, sections can be added or left out, and within a section parameters can be added or omitted (left blank). Please see this template's page for full documentation.
The overall width of the box; the default is normally fine. Using the unit "em" helps the box scale for different font sizes.
Default
22 em
Example
22 em
Unknown
optional
Custom CSS
style
Any additional CSS to apply to the box; see the width parameter to set the width.
Unknown
optional
Name
Name
Compound name for the chembox's title. Defaults to the page title.
Default
Page title.
Example
Ethanoic acid
String
suggested
Title reference
Reference
A reference to be shown in the title. Use <ref> tags or equivalent, such as {{cite book}}.
Content
optional
Title reference (2)
Chembox_ref
Equivalent to the title reference parameter; appears second if both are provided.
Unknown
optional
Image file (top row, full width)
ImageFile
An image file to display; omit "File:".
File
suggested
Image file (second row; full width)
ImageFile1
An image file to display; omit "File:".
File
optional
Image file (third row, left half)
ImageFileL1
An image file to display; omit "File:".
File
optional
Image file (third row, right half)
ImageFileR1
An image file to display; omit "File:".
File
optional
Image file (fourth row, full width)
ImageFile2
An image file to display; omit "File:".
File
optional
Image file (fifth row, right half)
ImageFileR2
An image file to display; omit "File:".
File
optional
Image file (fifth row, left half)
ImageFileL2
An image file to display; omit "File:".
File
optional
Image file (sixth row; full width)
ImageFile3
An image file to display; omit "File:".
File
optional
Image file (seventh row, left half)
ImageFileL3
An image file to display; omit "File:".
File
optional
Image file (seventh row, right half)
ImageFileR3
An image file to display; omit "File:".
File
optional
Image name (first row, full width)
ImageName
If set, this is the title of the image; it appears if you hover over it.
String
optional
Image size (first row, full width)
ImageSize
Image width in pixels, with px suffix.
Default
220px
Example
200px
String
optional
Image alt text (first row, full width)
ImageAlt
The text description read out to users who cannot see the image.
String
optional
Image caption (first row, full width)
ImageCaption
Caption displayed below the image.
Content
optional
Image reference (first row, full width)
ImageFile_Ref
A reference for this image. Use <ref> tags or equivalent such as {{cite book}}.
Content
optional
Image name (second row, full width)
ImageName1
If set, this is the title of the image; it appears if you hover over it.
String
optional
Image size (second row, full width)
ImageSize1
Image width in pixels, with px suffix.
Default
220px
Example
200px
String
optional
Image alt text (second row, full width)
ImageAlt1
The text description read out to users who cannot see the image.
String
optional
Image caption (second row, full width)
ImageCaption1
Caption displayed below the image.
Content
optional
Image reference (second row, full width)
ImageFile1_Ref
A reference for this image. Use <ref> tags or equivalent such as {{cite book}}.
Content
optional
Image name (third row, left half)
ImageNameL1
If set, this is the title of the image; it appears if you hover over it.
String
optional
Image size (third row, left half)
ImageSizeL1
Image width in pixels, with px suffix.
Default
110px
Example
200px
String
optional
Image alt text (third row, left half)
ImageAltL1
The text description read out to users who cannot see the image.
String
optional
Image caption (third row, left half)
ImageCaptionL1
Caption displayed below the image.
Content
optional
Image reference (third row, left half)
ImageFileL1_Ref
A reference for this image. Use <ref> tags or equivalent such as {{cite book}}.
Content
optional
Image name (third row, right half)
ImageNameR1
If set, this is the title of the image; it appears if you hover over it.
String
optional
Image size (third row, right half)
ImageSizeR1
Image width in pixels, with px suffix.
Default
110px
Example
200px
String
optional
Image alt text (third row, right half)
ImageAltR1
The text description read out to users who cannot see the image.
String
optional
Image caption (third row, right half)
ImageCaptionR1
Caption displayed below the image.
Content
optional
Image reference (third row, right half)
ImageFileR1_Ref
A reference for this image. Use <ref> tags or equivalent such as {{cite book}}.
Content
optional
Image caption (third row, left and right halves)
ImageCaptionLR1
Image caption for both halves of row 3.
Content
optional
Image name (fourth row, full width)
ImageName2
If set, this is the title of the image; it appears if you hover over it.
String
optional
Image size (fourth row, full width)
ImageSize2
Image width in pixels, with px suffix.
Default
220px
Example
200px
String
optional
Image alt text (fourth row, full width)
ImageAlt2
The text description read out to users who cannot see the image.
String
optional
Image caption (fourth row, full width)
ImageCaption2
Caption displayed below the image.
Content
optional
Image reference (fourth row, full width)
ImageFile2_Ref
A reference for this image. Use <ref> tags or equivalent such as {{cite book}}.
Content
optional
Image name (fifth row, left half)
ImageNameL2
If set, this is the title of the image; it appears if you hover over it.
String
optional
Image size (fifth row, left half)
ImageSizeL2
Image width in pixels, with px suffix.
Default
110px
Example
200px
String
optional
Image alt text (fifth row, left half)
ImageAltL2
The text description read out to users who cannot see the image.
String
optional
Image caption (fifth row, left half)
ImageCaptionL2
Caption displayed below the image.
Content
optional
Image reference (fifth row, left half)
ImageFileL2_Ref
A reference for this image. Use <ref> tags or equivalent such as {{cite book}}.
Content
optional
Image name (fifth row, right half)
ImageNameR2
If set, this is the title of the image; it appears if you hover over it.
String
optional
Image size (fifth row, right half)
ImageSizeR2
Image width in pixels, with px suffix.
Default
110px
Example
200px
String
optional
Image alt text (fifth row, right half)
ImageAltR2
The text description read out to users who cannot see the image.
String
optional
Image caption (fifth row, right half)
ImageCaptionR2
Caption displayed below the image.
Content
optional
Image reference (fifth row, right half)
ImageFileR2_Ref
A reference for this image. Use <ref> tags or equivalent such as {{cite book}}.
Content
optional
Image caption (fifth row, left and right halves)
ImageCaptionLR2
Image caption for both halves of row 5.
Content
optional
Image name (sixth row, full width)
ImageName3
If set, this is the title of the image; it appears if you hover over it.
String
optional
Image size (sixth row, full width)
ImageSize3
Image width in pixels, with px suffix.
Default
220px
Example
200px
String
optional
Image alt text (sixth row, full width)
ImageAlt3
The text description read out to users who cannot see the image.
String
optional
Image caption (sixth row, full width)
ImageCaption3
Caption displayed below the image.
Content
optional
Image reference (sixth row, full width)
ImageFile3_Ref
A reference for this image. Use <ref> tags or equivalent such as {{cite book}}.
Content
optional
Image name (seventh row, left half)
ImageNameL3
If set, this is the title of the image; it appears if you hover over it.
String
optional
Image size (seventh row, left half)
ImageSizeL3
Image width in pixels, with px suffix.
Default
110px
Example
200px
String
optional
Image alt text (seventh row, left half)
ImageAltL3
The text description read out to users who cannot see the image.
String
optional
Image caption (seventh row, left half)
ImageCaptionL3
Caption displayed below the image.
Content
optional
Image reference (seventh row, left half)
ImageFileL3_Ref
A reference for this image. Use <ref> tags or equivalent such as {{cite book}}.
Content
optional
Image name (seventh row, right half)
ImageNameR3
If set, this is the title of the image; it appears if you hover over it.
String
optional
Image size (seventh row, right half)
ImageSizeR3
Image width in pixels, with px suffix.
Default
110px
Example
200px
String
optional
Image alt text (seventh row, right half)
ImageAltR3
The text description read out to users who cannot see the image.
String
optional
Image caption (seventh row, right half)
ImageCaptionR3
Caption displayed below the image.
Content
optional
Image reference (seventh row, right half)
ImageFileR3_Ref
A reference for this image. Use <ref> tags or equivalent such as {{cite book}}.
Content
optional
Image caption (seventh row, left and right halves)
ImageCaptionLR3
Image caption for both halves of row 7
Content
optional
Image caption (all)
ImageCaptionAll
An overall image caption.
Content
optional
Other names
OtherNames
A list of other names. Using the {{Unbulleted list}} template is recommended, as separating names with commas can be ambiguous.
Example
{{Unbulleted list|Ethanoic acid|Acetic acid}}
Content
suggested
IUPAC name
IUPACName
For a single name. Use IUPAC names for a plural.
Content
suggested
IUPAC names
IUPACNames
For multiple names. Use IUPAC name for the singular.
Content
optional
Preferred IUPAC name
PIN
no description
Content
optional
Systematic IUPAC name
SystematicName
no description
Content
suggested
Names reference
Names_ref
A reference for the names. Use <ref> tags or equivalent such as {{cite book}}.
Content
optional
Pronunciation
pronounce
no description
Content
optional
Section 1
Section1
A section sub-template with more information. One of {{Chembox Identifiers}}, {{Chembox Properties}}, {{Chembox Structure}}, {{Chembox Thermochemistry}}, {{Chembox Explosive}}, {{Chembox Pharmacology}}, {{Chembox Hazards}}, or {{Chembox Related}}.
Content
suggested
Section 2
Section2
A section sub-template with more information. One of {{Chembox Identifiers}}, {{Chembox Properties}}, {{Chembox Structure}}, {{Chembox Thermochemistry}}, {{Chembox Explosive}}, {{Chembox Pharmacology}}, {{Chembox Hazards}}, or {{Chembox Related}}.
Content
suggested
Section 3
Section3
A section sub-template with more information. One of {{Chembox Identifiers}}, {{Chembox Properties}}, {{Chembox Structure}}, {{Chembox Thermochemistry}}, {{Chembox Explosive}}, {{Chembox Pharmacology}}, {{Chembox Hazards}}, or {{Chembox Related}}.
Content
suggested
Section 4
Section4
A section sub-template with more information. One of {{Chembox Identifiers}}, {{Chembox Properties}}, {{Chembox Structure}}, {{Chembox Thermochemistry}}, {{Chembox Explosive}}, {{Chembox Pharmacology}}, {{Chembox Hazards}}, or {{Chembox Related}}.
Content
suggested
Section 5
Section5
A section sub-template with more information. One of {{Chembox Identifiers}}, {{Chembox Properties}}, {{Chembox Structure}}, {{Chembox Thermochemistry}}, {{Chembox Explosive}}, {{Chembox Pharmacology}}, {{Chembox Hazards}}, or {{Chembox Related}}.
Content
suggested
Section 6
Section6
A section sub-template with more information. One of {{Chembox Identifiers}}, {{Chembox Properties}}, {{Chembox Structure}}, {{Chembox Thermochemistry}}, {{Chembox Explosive}}, {{Chembox Pharmacology}}, {{Chembox Hazards}}, or {{Chembox Related}}.
Content
suggested
Section 7
Section7
A section sub-template with more information. One of {{Chembox Identifiers}}, {{Chembox Properties}}, {{Chembox Structure}}, {{Chembox Thermochemistry}}, {{Chembox Explosive}}, {{Chembox Pharmacology}}, {{Chembox Hazards}}, or {{Chembox Related}}.
Content
optional
Section 8
Section8
A section sub-template with more information. One of {{Chembox Identifiers}}, {{Chembox Properties}}, {{Chembox Structure}}, {{Chembox Thermochemistry}}, {{Chembox Explosive}}, {{Chembox Pharmacology}}, {{Chembox Hazards}}, or {{Chembox Related}}.
Content
optional
Section 9
Section9
A section sub-template with more information. One of {{Chembox Identifiers}}, {{Chembox Properties}}, {{Chembox Structure}}, {{Chembox Thermochemistry}}, {{Chembox Explosive}}, {{Chembox Pharmacology}}, {{Chembox Hazards}}, or {{Chembox Related}}.
{{Chembox Hazards}} - complete listGHS reference (e.g. Template:Sigma-Aldrich)GHS pictograms. Use GHS templates, e.g., ={{GHS01}}{{GHS07}}GHS signal word ("Danger", "Warning")GHS hazard statements. Use {{H-phrases}}GHS precautionary statements. Use {{P-phrases}}{{NFPA 704 diamond}}:Health (blue) hazard code (0–4 or -)Flammability (red) hazard code (0–4 or -)Instability–reactivity (yellow) hazard code (0–4 or -). Alias: NFPA-R=Special hazards (white). See {{NFPA 704 diamond}}Reference for the NFPA fire diamondFlash point, any text Temperature, number in C. Can be a range: '50 to 60'. Also _PtF, _PtK. (see: temperatures)Autoignition point, any text Temperature, number in C. Can be a range: '50 to 60'. Also _PtF, _PtK. (see: temperatures)Threshold limit valueThreshold limit value: time-weighted averageThreshold limit value: short-term exposure limitThreshold limit value: ceiling limitLethal dose, 50% (median lethal dose). Specify species and method (oral/dermal/intravenous), e.g., 950mg/kg (rat, oral)Lowest lethal doseLethal concentration, 50% (median lethal concentration)Lowest lethal concentrationPermissible exposure limitRecommended exposure limitImmediately dangerous to life or health valueLink to an external safety data sheet