Widgets

How to Add a States of Matter Simulator to Your Website

LK Forge · 4 min read · Updated September 2026

You can add a full states of matter simulation to any website, blog, or classroom page with a single line of code — free, with no sign-up, no plugin, and no script to install. Visitors heat a box of atoms and watch it melt and boil, then cool it and watch it freeze. This guide covers the fastest way to embed the States of Matter Simulator, what it teaches, and where it works.

The quickest way: paste one embed snippet

An embed is just an <iframe> that loads the simulator from lkforge.com, plus a small credit line. Copy this into your page’s HTML where you want the widget to appear:

<iframe src="https://lkforge.com/embed/states-of-matter/"
        width="100%" height="900" loading="lazy"
        style="border:0;max-width:560px"
        title="States of Matter Simulation by LK Forge"></iframe>
<p><a href="https://lkforge.com/tools/physics/states-of-matter/">States of Matter Simulation</a>
   by <a href="https://lkforge.com/">LK Forge</a></p>

The <iframe> is the live simulator; the <p> underneath is a plain credit link. Keep that line — the visible link is what keeps the widget free to embed. You can also copy this exact code straight from the LK Forge widget gallery.

What the widget shows

The simulator opens with a warm box of argon atoms, so a visitor sees them moving immediately and can then take control:

  • Substance: switch between neon, argon, oxygen and water, which melt and boil at different temperatures.
  • Heat control: add or remove heat with the slider or the buttons to drive the material between phases.
  • Emergent phases: a cold lattice, a flowing liquid, and a gas that fills the box — all from the forces between atoms.
  • Live readout: the temperature in kelvin and the current state, solid, liquid or gas.

Pick the right height

The snippet uses height="900", which fits the atom box, the substance menu, the heat control, the buttons and the readouts without clipping even on a narrow phone, where they stack into one column. On a wider page the widget centres within its max-width:560px. That single height works across screen sizes, so there is nothing to tweak for mobile.

Where it works

Because it is a standard iframe, the embed works anywhere you can add HTML:

  • WordPress: add a Custom HTML block and paste the snippet.
  • Squarespace: use a Code / Embed block.
  • Wix: add an Embed HTML / iframe element.
  • Ghost: insert an HTML card.
  • Notion: paste the /embed/states-of-matter/ URL and choose "Create embed".
  • Plain HTML, an intranet, or a lesson page: paste the snippet straight into the markup.

That’s the whole job. Copy the embed code from the widget gallery and paste it wherever a chemistry or physics lesson or a blog post on solids, liquids, gases or phase changes needs atoms students can actually heat.

Grab the embed code from the LK Forge widget gallery — free, no sign-up.

Open the States of Matter Simulator

Frequently asked questions

Is embedding the states of matter simulator free?
Yes. It is free to embed on any site, with no account, no API key and no usage limits. The whole simulation runs in your visitor’s own browser, so there is no server cost — we only ask that you keep the small "States of Matter Simulation by LK Forge" credit line that comes with the embed code.
What can visitors do with the embedded simulator?
They can choose a substance — neon, argon, oxygen or water — and use a heat control to add or remove energy. Cold, the atoms lock into a vibrating triangular lattice; adding heat melts it into a flowing liquid and then boils it into a gas, while cooling freezes it back. A live panel shows the temperature in kelvin and the current phase.
Is it a real molecular simulation?
Yes. The atoms attract and repel through the Lennard-Jones potential and their motion is integrated with the velocity-Verlet method, so the melting and boiling are not scripted animations — they emerge from the forces between the atoms. The temperature is computed from the atoms’ average kinetic energy and the solid, liquid or gas label is read from that temperature.
What iframe height should I use, especially on mobile?
The snippet ships with height="900", which is tall enough that the atom box, the substance menu, the heat control, the buttons and the readouts all fit without clipping even on a narrow phone where everything stacks into a single column. On a wider page the widget simply centres within its max-width of 560px. If you want it shorter you can lower the height, but 900 is the safe default across screen sizes.
Where can I embed it — WordPress, Wix, Squarespace, Notion?
Anywhere you can add HTML, because it is a standard iframe. In WordPress use a Custom HTML block; in Squarespace a Code/Embed block; in Wix an Embed HTML element; in Ghost an HTML card; in Notion paste the /embed/states-of-matter/ URL as an embed. On a plain HTML page or an intranet, paste the snippet straight into the markup.
Does the embedded simulator track visitors or set cookies?
No. Everything runs locally in the visitor’s browser — nothing is uploaded. The embed sets no tracking cookies and sends no analytics, so it is safe to place on a privacy-sensitive site, an intranet, or a page for students.