WOLFRAM

Wolfram Language & System Documentation Center

PeriodicTablePlot[]

returns a graphical representation of the periodic table.

PeriodicTablePlot[EntityProperty["Elemment","prop"]]

gives the periodic table with elements colored according to the specified property.

PeriodicTablePlot[Entity["Element","elem"]]

shows the periodic table with the specified element highlighted.

PeriodicTablePlot[{elem1,elem2,…}]

highlights a list of elements.

PeriodicTablePlot[EntityClass["Element","class"]]

shows the periodic table with all elements in "class" highlighted.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Generalizations & Extensions  
Options  
Background  
ColorFunction  
PlotLabel  
PlotLegends  
See Also
Related Guides
History
Cite this Page

PeriodicTablePlot

PeriodicTablePlot[]

returns a graphical representation of the periodic table.

PeriodicTablePlot[EntityProperty["Elemment","prop"]]

gives the periodic table with elements colored according to the specified property.

PeriodicTablePlot[Entity["Element","elem"]]

shows the periodic table with the specified element highlighted.

PeriodicTablePlot[{elem1,elem2,…}]

highlights a list of elements.

PeriodicTablePlot[EntityClass["Element","class"]]

shows the periodic table with all elements in "class" highlighted.

Details and Options

Examples

open all close all

Basic Examples  (3)

Show the periodic table:

Wolfram Language code: PeriodicTablePlot[]

Color the periodic table based on an "Element" property:

Wolfram Language code: PeriodicTablePlot["Phase"]

Highlight one element in the periodic table:

Wolfram Language code: PeriodicTablePlot[Entity["Element", "Carbon"]]

Scope  (3)

Highlight a period in the periodic table:

Wolfram Language code: PeriodicTablePlot[EntityClass["Element", "Period4"]]

Use FreeformEvaluate to specify elements using common names:

Wolfram Language code: PeriodicTablePlot[{[carbon], [nitrogen], [oxygen], [phosphorus], [hydrogen], [chlorine]}]

Highlight a group in the periodic table:

Wolfram Language code: PeriodicTablePlot[EntityClass["Element", "NobleGas"]]

Generalizations & Extensions  (1)

Plot the structure diagram for an organohalide:

Wolfram Language code: MoleculePlot[mol = Molecule[{"O", "C", "O", "C", "C", Atom["C", "HydrogenCount" -> 1], "C", "O", "N", Atom["C", "HydrogenCount" -> 1], "C", "O", "N", "C", "C", "O", "O", "C", "S", "C", Atom["C", "HydrogenCount" -> 1], "Br", "Cl", "F", "F", "N"}, {Bond[{1, 2}, ... 6, "Direction" -> "Clockwise"], Association["StereoType" -> "Tetrahedral", "ChiralCenter" -> 10, "Direction" -> "Counterclockwise"], Association["StereoType" -> "Tetrahedral", "ChiralCenter" -> 21, "Direction" -> "Clockwise"]}}]]

Highlight all the elements in the molecule in the periodic table:

Wolfram Language code: PeriodicTablePlot[mol["Elements"]]

Options  (7)

Background  (1)

Add a background to the periodic table:

Wolfram Language code: PeriodicTablePlot[Background -> StandardBlue]

ColorFunction  (3)

Use a different color function for the periodic table:

Wolfram Language code: PeriodicTablePlot[ColorFunction -> "BrightBands"]

Use a color function with a property that returns categorical data:

Wolfram Language code: PeriodicTablePlot[EntityProperty["Element", "Group"], ColorFunction -> ColorData[97]]

Use a color function with a property that returns categorical data:

Wolfram Language code: PeriodicTablePlot[EntityProperty["Element", "Electronegativity"], ColorFunction -> "AvocadoColors"]

PlotLabel  (1)

Add a label to the periodic table:

Wolfram Language code: PeriodicTablePlot[PlotLabel -> Style["Periodic Table of the Elements", Large, StandardRed]]

PlotLegends  (2)

With the default setting of PlotLegendsAutomatic, some inputs do not show a legend:

Wolfram Language code: PeriodicTablePlot[]

Use PlotLegendsTrue to force a legend:

Wolfram Language code: PeriodicTablePlot[PlotLegends -> True]

With the default setting of PlotLegendsAutomatic, some inputs show a legend by default:

Wolfram Language code: PeriodicTablePlot[EntityProperty["Element", "AtomicRadius"]]

Use PlotLegendsFalse to disable automatic plot legends:

Wolfram Language code: PeriodicTablePlot[EntityProperty["Element", "AtomicRadius"], PlotLegends -> False]
Wolfram Research (2026), PeriodicTablePlot, Wolfram Language function, https://reference.wolfram.com/language/ref/PeriodicTablePlot.html.

Text

Wolfram Research (2026), PeriodicTablePlot, Wolfram Language function, https://reference.wolfram.com/language/ref/PeriodicTablePlot.html.

CMS

Wolfram Language. 2026. "PeriodicTablePlot." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/PeriodicTablePlot.html.

APA

Wolfram Language. (2026). PeriodicTablePlot. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/PeriodicTablePlot.html

BibTeX

@misc{reference.wolfram_2026_periodictableplot, author="Wolfram Research", title="{PeriodicTablePlot}", year="2026", howpublished="\url{https://reference.wolfram.com/language/ref/PeriodicTablePlot.html}", note=[Accessed: 12-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_periodictableplot, organization={Wolfram Research}, title={PeriodicTablePlot}, year={2026}, url={https://reference.wolfram.com/language/ref/PeriodicTablePlot.html}, note=[Accessed: 12-June-2026]}