This template tracks one or more Wikidata properties; see § Input from Wikidata for details.
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:
Title (default: article name) Reference, use <ref> </ref> and add <references/> to the page IUPAC name The systematic name(s) Any other name(s)
Like filename.svg (not [[image:filename.svg]]) Picture width (default=200px; example: ImageSize=100px) Alt text for picture (example: Fine dry white powder) Picture caption (example: Oxygen in liquid form)
InChI, no link KEGG, links to genome.ad.jp Medical Subject Headings, links to NIH PubChem, links to pubchem RTECS, no link SMILES, no link
{{Chembox Properties}}: physical properties Atmospheric OH rate constant Its appearance Boiling point, in plain text Notes on boiling point Density, including unit The molecular formula Henry's law constant (kH) Partition coefficient Molecular weight, including unit Melting point, in plain text Notes on melting point pKa pKb Solubility in water Solubility in other solvents, goes together with next In which solvent it is soluble Vapor pressure
{{Chembox Pharmacology}}: drug data ATCvet=yes if the next two parameters define an ATCvet code ATCCode prefix (first three characters, omit the leading Q for ATCvet codes), internal link ATCCode suffix (last 4 characters), full ATC links to WHO C.C. Other ATC codes (use the {{ATC}} and/or {{ATCvet}} templates) Admin Routes Bioavailability Excretion Half Life Metabolism Legal status Legal status in AU
Autoignition temperature EU Class EU Index Explosion limits URL for Safety Data Sheet Flash point LD50 LC50 Main hazards NFPA-F: Fire hazard 0–4 (red) NFPA-H: Health hazard 0–4 (blue) NFPA-R: Reactivity hazard 0–4 (yellow) NFPA-S: Special hazards (aka Other; white): W, OX, COR, ALK, ACID, CRYO, RA PEL HPhrases: use the {{H-phrases}} template for this PPhrases: use the {{P-phrases}} template for this
{{Chembox Related}}: related substances The function Other anions Other cations Other compounds: adds a chemical 'see also' section Other function:
Full form
To use, simply copy and paste the left column into the document, and press save to get an empty Chembox:
Indexed parameters take indexes 'blank', 1–5 (six options together). They should have straight input, such as a correct CAS Registry Number.
Eight base parameters are indexed this way, all identifiers:
CASNo, ChEBI, ChEMBL, ChemSpiderID, DrugBank, InChI, KEGG, PubChem, SMILES, UNII
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.
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.
Adding images
Parameters
Image parameters for the first images:
{{Chembox<!-- Other chembox parameters can go here --><!-- Row 1/9 -->{{Chemboximage|ImageFile=|ImageName=|ImageSize=|ImageAlt=|ImageCaption=|ImageFile_Ref=}}<!-- Row 2/9 -->{{Chemboximage|ImageFile1=|ImageName1=|ImageSize1=|ImageAlt1=|ImageCaption1=|ImageFile1_Ref=}}<!-- Row 3/9 -->{{Chemboximagesbs|ImageFileL1=|ImageNameL1=|ImageSizeL1=|ImageAltL1=|ImageCaptionL1=|ImageFileL1_Ref=|ImageFileR1=|ImageNameR1=|ImageSizeR1=|ImageAltR1=|ImageCaptionR1=|ImageFileR1_Ref=}}<!-- More chembox parameters can go here, like |Section1=... -->}}
Examples
Image parameters for an image (example: File1). All are optional.
Chembox
A caption shows here
Tracking categories (test):
{{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 = 120px| ImageFile1_Ref =ref}}
Adding two images:
Chembox
Tracking categories (test):
{{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
Tracking categories (test):
{{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 images ordering
row 1
ImageFile
row 2
ImageFile1
row 3
ImageFileL1
ImageFileR1
row 4
ImageFileL2
ImageFileR2
row 5
ImageFile2
row 6
ImageFile3
row 7
ImageFileL3
ImageFileR3
row 8
ImageFileL4
ImageFileR4
row 9
ImageFile4
This gives the possibility to play a bit with which image is first (rows with empty parameters are not displayed). Example:
{{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.
{{Chembox Identifiers}}------CAS registry number, links to http://www.commonchemistry.org/ CAS registry number commentOther CAS RN (unformatted)------ChEBI, links to http://www.ebi.ac.uk/chebi/------CHeMBL------ChemSpider ID, links to http://www.chemspider.com/ ChemSpider ID commentChemSpider ID verified? If yes, type: {{Chemspidercite}}Other ChemSpider ID------DrugBank commentOther DrugBank------IUPHAR/BPS commentOther IUPHAR------KEGG entry, links to http://www.genome.jp/kegg/------PubChem compound ID, links to http://pubchem.ncbi.nlm.nih.gov/PubChem compound ID commentOther PubChem compound ID------SMILES SMILES commentOther SMILES------StdInChI StdInChI commentStdInChI Key StdInChI Key comment------InChI InChI commentOther InChIInChI Key InChI Key commentOther InChI Key------UNII: Unique Ingredient Identifier, by FDA UNII commentOther UNII------3DMET entry, links to http://www.3dmet.dna.affrc.go.jp/AbbreviationsBeilstein referenceEC_number (aka EINECS)E number (food additive code)Gmelin IDUN numberMeSH heading, links to http://www.nlm.nih.gov/mesh/RTECS number
{{Chembox Properties}} - incomplete listReferenceChemical formula reference comment per element (alternative input) molecule chargeMolarMassMolarMassRoundMolarMass_refMolarMass_notesAppearanceOdor, OdourDensityMeltingPt, any textNumber, in Celsius. Is converted to F and K Also possible: MeltingPtF=, or MeltingPtK= BoilingPt, any textNumber, in Celsius. Is converted to F and K Also possible: BoilingPtF=, or BoilingPtK= SublimationConditionsSolubility in water (Aqueous solution)SolubilityProductSolubilityProductAsSolubleOtherSolventSolubility1[[{{{Solvent1}}}]]Solubility2[[{{{Solvent2}}}]]Solubility3[[{{{Solvent3}}}]]Solubility4[[{{{Solvent4}}}]]Solubility5[[{{{Solvent5}}}]] CMC HLBLogPVaporPressureHenryConstantAtmosphericOHRateConstantpKapKbIsoelectricPtLambdaMaxAbsorbanceBandGapElectronMobilitySpecRotationMagSusThermalConductivityRefractIndexViscosityCriticalRelativeHumidityDipoleOrbitalHybridisationSpecificSurfaceAreaPoreVolumeAveragePoreSize
{{Chembox Structure}}Reference in headerCrystal structureSpace group (free text)Point groupLattice constant (a, b, c)α, β, γ angles (don't add the ° sign)Reference for the lattice valuesComment for lattice (any text)Lattice volumeNumber of formulasCoordination geometryMolecular geometryOrbital hybridisationDipole moment
{{Chembox Hazards}} - complete listlink to (data page)#Safety data sheetlink to an external Material safety data sheet (MSDS)Danger pictograms according to GHS GHS Signal Word - See ವರ್ಗ:GHS templatesGHS Hazard statementsGHS Precautionnary statementsRisk phrases (EU system)Safety phrases (EU system)Flammability by NFPA 704, red. See {{NFPA 704 diamond}} documentationHealth, blue. Health hazard code (0–4 or -)Reactivity, yellow. Reactivity hazard code (0–4 or -)Special hazards, white. Other hazard codes (like W, OX, RA, -. See list)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) PELThreshold Limit ValueThreshold Limit Value: Time Weighted AverageThreshold Limit Value: Short Time Exposure LimitLethal dose for half a population either by oral, dermal or intravenous
{{Chembox Footer}} - (Chembox internal only; parameters entered in main {{Chembox}})Set lefthand text column width (default is 40%; see also 'width=' option in {{Chembox}})Set '=no' will hide the standard state noticeAllows a general note in the bottom boxSet '=no' will hide the infobox reference notice Bot maintainedDo not edit, add or remove these fields
Four or less parameters are needed to present temperature data:
|MeltingPt=Decomposes when > |MeltingPtC=50 |MeltingPt_ref=<ref>[www.example.com]</ref> |MeltingPt_notes=My notes<ref>[www.chemspider.com]</ref>
Decomposes when >_50 °C (122 °F; 323 K)[1]_My notes[2]
The options for conversion: |MeltingPtC=50 |MeltingPtF=50 |MeltingPtK=50 Temperature range: |MeltingPtC=50 to 70 |MeltingPtF=50 to 70 |MeltingPtK=50 to 70
50 °C (122 °F; 323 K) 10 °C; 50 °F; 283 K −223.2 °C; −369.7 °F; 50.0 K
50 to 70 °C (122 to 158 °F; 323 to 343 K) 10 to 21 °C; 50 to 70 °F; 283 to 294 K −223.2 to −203.2 °C; −369.7 to −333.7 °F; 50.0 to 70.0 K
{{Chembox Properties}} - all temperature parametersAny text for melting point valueTemperature, number only. Can be a range: '100 to 200' number, when in degrees Fahrenheit number, when in kelvinsReferences (always shows, right after calculations or 'any text')Notes (always shows last; can include references)Any text for boiling point valueTemperature, number only. Can be a range: '100 to 200' number, when in degrees Fahrenheit number, when in kelvinsReferences (always shows, right after calculations or 'any text')Notes (always shows last; can include references)
{{Chembox Hazards}} - all temperature parametersAny text for Flash point value.Temperature, number only. Can be a range: '100 to 200' number, when in degrees Fahrenheit number, when in kelvinsReferences (always shows, right after calculations or 'any text')Notes (always shows last; can include references)Any text for autoignition temperature valueTemperature, number only. Can be a range: '100 to 200' number, when in degrees Fahrenheit number, when in kelvinsReferences (always shows, right after calculations or 'any text')Notes (always shows last; can include references)
By {{Chembox}} and {{Infobox drug}} settings, a CheMoBot checks articles for parameter validation. The bot then adds and sets templates like {{cascite}} to the article.
A template like {{cascite}} is added and set by CheMoBot automatically after certain edits. Depending on the earlier data checks, the template will be marked "correct" or "changed" (i.e., to be checked). 'changed' articles are categorized for maintenance.
For example, when parameter |CASNo= is changed in the article, the bot sets |CASNo_Ref={{cascite|changed|??}} initially. See
By {{Chembox}} and {{Drugbox}} settings, a bot checks articles for parameter validation. The bot then adds and sets templates like {{cascite}} to the article. Depending on the template settings, articles are categorized for maintenance.
Usage
A template is added and set by User:CheMoBot automatically after certain edits. Depending on the earlier data checks, the template will be marked "correct" or "changed" (i.e., to be checked). 'changed' articles are categorized.
For example, when parameter |CASNo= is changed in the article, the bot sets |CASNo_Ref={{cascite|changed|??}} initially. See WP:WikiProject Chemicals/Chembox validation.
Initially the parameters are set {{cascite|changed|??}}
The primary parameter can have an index (see its documentation):
|CASNo3=1234-56-7
|CASNo3_Ref={{cascite|...|...}}
Indexed parameters like |CASNo1= and |CASNo2= are verified too, and are treated independently. So an article can have: |CASNo={{cascite|correct|CAS}} and |CASNo3={{cascite|changed}}.
Data 'correct' or 'changed' (parameter #1)
The first parameter is either correctY or changedN always: {{cascite|correct|CAS}}. Cross-marked articles are categorized as 'changed'. With any other text like monkeyN, again the cross is shown and the article is categorized, now sorted under "?".
Correct by source (parameter #2)
Initially, the bot sets this to |?? (='source unknown').Parameter #2 has the source that confirms the statement. By confirmation, the parameter can mention the confirming source. When that source is not the standard (as listed above), the input source is mentioned in a superscript linked: