Chemicals and SDS

The Chemicals page is an inventory of the hazardous substances held on your sites, with their GHS hazard classification, signal word, storage quantities, and a link to each substance's safety data sheet (SDS). It flags missing SDSs, overdue SDS reviews, quantities over your threshold, and banned substances that are still in use. The page lives at /chemicals and is called Chemicals & SDS. It supports GHS and OSHA HazCom (29 CFR 1910.1200) plus the hazardous-substance expectations of ISO 45001 and ISO 14001.

Before you start

• Module is off by default. An org admin must turn on Chemicals (SDS) under Settings > Modules (in the Health, safety & environment group). Until then the /chemicals route is blocked.
• Any signed-in member of the organization can manage the inventory.
• Upload your SDS files to Documents first. The SDS link on a chemical points at a document, and the picker only offers documents that already exist.
• Optional: set up sites (see Departments and Sites) so each chemical can be tied to where it is stored.

Add a chemical

1. Open Chemicals & SDS and click Add Chemical.
2. Fill the dialog:
   • Name (required), for example "Acetone".
   • CAS number (for example 67-64-1) and Supplier.
   • GHS hazard classes: click the tags that apply. The choices are Flammable, Corrosive, Toxic, Oxidizing, Environmental hazard, Health hazard, Irritant, and Compressed gas. The acute classes (Flammable, Corrosive, Toxic, Oxidizing) render red in the register; the rest render magenta.
   • Signal word: Danger, Warning, or None, straight from the GHS label.
   • Status: In use (default), Phasing out, Banned, or Archived.
   • Banned substance toggle: use this for substances your organization prohibits. If a chemical is both banned and still In use, the dialog shows a red warning and the register flags it.
   • Location (for example "Flammables cabinet A") and Site.
   • Quantity, Unit (for example L or kg), and Max quantity: the stored amount and the threshold it must stay under.
3. In the Safety Data Sheet box:
   • Pick the SDS document from Documents.
   • Set the SDS issue date. The dialog immediately shows the computed review date: issue date plus 36 months.
4. Add Notes (handling precautions, PPE, storage notes) and click Add chemical.

Link or update an SDS

Every hazardous chemical on site needs an accessible SDS. Rows without one show a red No SDS tag and a Link SDS shortcut button.

1. Click Link SDS on the row (or the pencil icon). The dialog opens scrolled to the Safety Data Sheet section.
2. Pick the SDS document and set the SDS issue date.
3. Click Save.

The review-due date is recomputed automatically as issue date plus 36 months whenever the issue date changes, and cleared if you clear the issue date. On the register, the SDS tag is clickable and opens the linked document. When the review date passes, the tag turns red with "overdue" and the SDS review overdue stat counts it. To renew, record the new SDS issue date (and swap the document if the supplier issued a new revision); the review date rolls forward another 36 months.

Watch quantities and banned substances

• If both Quantity and Max quantity are set and the quantity is higher, the row shows a red quantity tag ending in "over" and the chemical counts under Over quantity threshold.
• A chemical with the Banned substance toggle on but status still In use gets a red "Banned" flag on its row, and a Banned in use stat chip appears in the header. Fix it by moving the substance to Phasing out or Banned status once it is off the floor, or by removing it.

Find things in the register

• The stats bar counts In use, SDS missing, SDS review overdue, Over quantity threshold, and (when above zero) Banned in use. Archived chemicals are excluded from every count.
• Filter with the Status dropdown, the Hazard class dropdown, and the Search box, which matches name or CAS number.

Archive a chemical

Click the trash icon on a row. The chemical's status becomes Archived: it is kept for your records but drops out of all register stats. There is no confirmation dialog. To bring it back, edit it and set the status again.

Try it

• Enable Chemicals (SDS) in Settings > Modules. Expected: Chemicals & SDS appears in the side nav and /chemicals loads.
• Add "Acetone" with CAS 67-64-1, hazard class Flammable, signal word Danger, and no SDS. Expected: the row shows red Flammable and Danger tags, a red No SDS tag, and SDS missing counts 1.
• Click Link SDS on the row. Expected: the edit dialog opens scrolled to the Safety Data Sheet box.
• Pick an SDS document and set an issue date. Expected: the dialog shows "Review due" at issue date plus 36 months; after saving, the row shows a blue SDS tag and SDS missing drops to 0.
• Click the SDS tag on the row. Expected: the linked document opens in Documents.
• Set an SDS issue date more than 36 months ago. Expected: the review tag turns red with "overdue" and SDS review overdue counts it.
• Set Quantity 30, Unit L, Max quantity 25. Expected: a red quantity tag ending in "over" and Over quantity threshold counts 1.
• Turn on Banned substance while status is In use. Expected: a red warning in the dialog, a red banned flag on the row, and a Banned in use stat chip in the header.
• Type "67-64" in Search. Expected: the list narrows to chemicals whose name or CAS number matches.
• Click the trash icon on a test chemical. Expected: a toast says it was archived and every stat ignores it.

If something goes wrong

• The page is missing or blocked. The Chemicals (SDS) module is off by default. Ask an org admin to enable it in Settings > Modules.
• Add chemical does nothing. Name is required.
• The SDS document I need is not in the picker. The picker lists existing documents (up to 500, by title). Upload the SDS in Documents first, then reopen the dialog.
• The review date looks wrong. It is always the issue date plus 36 months, computed automatically. To change it, change the issue date.
• No quantity warning appears. The check needs both Quantity and Max quantity filled in. Both accept numbers only.
• A hazard class I saved is gone. Only the eight listed GHS classes are recognized. Anything else stored in the database is dropped when the page loads.
• A chemical disappeared from the stats. Archived chemicals are excluded from every count. Check the Status filter for Archived to find it.