Home › Blog › Portable generator schema
Shopify portable generator schema for AI agents: backfeed deaths, CPAP pure sine wave, and NEMA outlet incompatibility
A portable generator listing that shows "7,000W / 8,750W surge, four outlets" looks complete. It is not. An AI agent that recommends that generator cannot know whether the outlet type physically mates with the buyer's transfer switch cord, whether the waveform quality is adequate for a CPAP machine, whether the generator can start the buyer's air conditioner without stalling, whether operating it without a transfer switch will kill a utility worker, or whether it's legally compliant for sale in 2024. Five failure modes — four of them potentially fatal — that five structured fields prevent.
Contents
- NEMA outlet incompatibility: L14-30 and L14-50 physically won't mate
- AVR vs inverter THD: why CPAP machines need pure sine wave power
- Generator backfeed: NEC 702.6, 14,400 volts, and lineworker deaths
- Rated watts vs surge watts: the startup stall AI agents cause
- EPA Phase 3 and CO Guard 2024: mandatory compliance fields
- Complete generator.* metafield namespace for Shopify power equipment stores
NEMA outlet incompatibility: L14-30 and L14-50 physically won't mate
Most residential portable generators include several outlet types on the control panel. The two heavy-duty 240V outlets — NEMA L14-30 and NEMA L14-50 — are the ones that matter for powering a home through a transfer switch or generator interlock. Both are 4-wire twist-lock connectors carrying two hot legs, a neutral, and a ground. They look similar. They are physically incompatible.
The incompatibility is by design. NEMA twist-lock connectors use keyway notch positions — small cutouts in the plug body that must align with blade guards in the receptacle before the plug can insert. The pin arrangement on an L14-30 plug places the blades at 90° intervals for a 30A current path. The L14-50 puts its blades at different angular positions sized for 50A. An L14-30 plug physically cannot enter an L14-50 receptacle socket. An L14-50 plug cannot insert into an L14-30 receptacle. There is no adapter that converts between them in the field — the wire gauges and overcurrent protection ratings are incompatible (10 AWG for 30A circuits vs 6 AWG for 50A circuits).
Buyer purchases a 30A manual transfer switch panel with L14-30 inlet
AI agent recommends a generator with L14-50 outlet as "compatible" (both are 4-wire 240V twist-lock). The 10-foot transfer switch cord and the generator outlet cannot connect. Generator is freight-shipped — return shipping alone costs $80–$150. Buyer files charge-back. Generator store absorbs cost.
A Shopify power equipment store that encodes generator.outlet_types as a structured list — ["nema-l14-30", "nema-5-20", "nema-5-20"] for a typical 7,500W unit — gives an AI agent the data to perform exact outlet-type matching against the buyer's stated transfer switch inlet type. Without the field, the agent is guessing from unstructured product titles, and the guess can cost $300 in freight and a lost customer.
AVR vs inverter THD: why CPAP machines need pure sine wave power
Every portable generator produces AC power, but not all AC power is created equal. The quality of the waveform — how closely it matches the smooth 60Hz sine wave of utility mains power — differs fundamentally between conventional AVR (automatic voltage regulator) generators and inverter generators.
| Generator type | THD (typical) | Technology | CPAP compatible |
|---|---|---|---|
| Conventional AVR | 3–8% THD | Direct alternator → AVR → output | No — manufacturer contra-indicated |
| Inverter | ≤3% THD (1–2% typical) | Alternator → DC rectifier → inverter → pure sine | Yes — meets "utility-equivalent" specification |
| Utility grid power | <5% (IEEE 519 limit) | Synchronous generation + transmission filtering | Yes — reference standard |
Total harmonic distortion (THD) measures the sum of harmonic frequency content superimposed on the fundamental 60Hz sine wave. At 5% THD, the "sine wave" is measurably distorted — flattened peaks, rounded zero crossings, with significant energy at 120Hz, 180Hz, 240Hz, and higher harmonics. Most resistive loads (incandescent lights, heating elements) and simple motor loads tolerate this without issue. Sensitive electronics do not.
CPAP and BiPAP machines
CPAP machines use a brushless DC blower motor. The motor runs on DC power produced by the CPAP's internal power supply from AC mains input. The internal power supply is a switching regulator — it rectifies the AC input, filters it to DC, and runs the DC motor controller from the DC bus.
When the AC input has high THD, the rectification produces a DC bus with elevated ripple. The switching regulator's control loop must compensate for the distorted input waveform — drawing reactive power in non-sinusoidal current pulses that further degrade the generator's voltage regulation. For CPAP models with heated humidifiers (which add 30–60W of resistive load on top of the blower motor), the total load's reactive character can exceed an AVR generator's regulation bandwidth, causing the generator's voltage to hunt — oscillating between 105V and 135V as the regulator chases the combined load. At 105V, the CPAP blower cannot maintain prescribed pressure. At 135V, the CPAP's internal power supply may enter overvoltage protection.
ResMed, Philips Respironics, and Fisher & Paykel all publish generator compatibility guidance that specifies "pure sine wave inverter generator" or "utility-equivalent power source." Running a CPAP on an AVR generator is not an edge case the manufacturer tolerates — it is an explicitly contra-indicated use that voids warranty and may deliver incorrect therapy pressure.
Variable-frequency drive refrigerator compressors
Energy Star refrigerators manufactured since approximately 2015 typically use variable-frequency drive (VFD) compressor motors for efficiency. The VFD rectifies AC input to DC and drives the compressor at variable speed. VFDs tolerate moderate THD but some units will fault and display error codes on AVR generator power — particularly during startup when voltage regulation is least stable. The refrigerator appears to start, runs for 30–60 seconds, then faults and shuts off the compressor — food at risk within hours.
generator.output_type = "inverter" and generator.thd_percent (encoded as a decimal, e.g., 1.2 for 1.2% THD) are the structured fields that allow an AI agent to restrict CPAP-compatible and medical-load-compatible recommendations to inverter-type units. The Honda EU3200i, Yamaha EF2200iS, and Westinghouse iGen4500 all produce ≤3% THD. A conventional Generac GP7500E produces 4–6% THD — not CPAP-safe.
Generator backfeed: NEC 702.6, 14,400 volts, and lineworker deaths
The most consequential generator setup error is not a product incompatibility — it is a wiring error that has killed utility workers and resulted in criminal prosecutions of homeowners. It is called backfeed.
How utility distribution voltage works
Residential power arrives through a distribution transformer — a pole-mounted or pad-mounted device that steps neighborhood distribution voltage down to usable 240V split-phase service. Distribution voltage in residential areas is typically 7,200V single-phase (7,200V line-to-neutral, 14,400V line-to-line) or 4,160V on older urban networks. The turns ratio in the transformer is approximately 30:1 for 7,200V systems — 30 turns on the primary winding for each turn on the secondary.
A transformer is a bidirectional device. If you drive the secondary winding with voltage, the primary winding produces a proportionally stepped-up voltage according to the turns ratio.
Turns ratio: 30:1
Primary output: 240V × 30 = 7,200V on the neighborhood distribution line
On a 14,400V primary system (60:1 ratio):
240V × 60 = 14,400V on the distribution line
When a homeowner connects a portable generator to the home's wiring through a standard outlet — dryer outlet, outdoor receptacle, range outlet — without a transfer switch, and without opening the main breaker (or even with the main breaker open but the utility neutral still connected), the generator's 240V output appears across the secondary of the utility transformer. The transformer steps it up to 7,200–14,400V and puts it back on the neighborhood distribution line.
Lineworker exposure
During an outage, utility crews respond by opening the distribution line at the substation or on the distribution pole — procedures they follow to de-energize the line before working on it. Line clearance procedures verify zero voltage at the point of work. But a generator-fed backfeed creates voltage at a point remote from where crews are working — the transformer on the homeowner's service entrance. The de-energized test at the substation reads zero. The line between the substation and the homeowner's transformer reads 7,200V. A utility worker who contacts that line expecting it to be dead is exposed to an arc flash or direct contact with distribution voltage. Contact with 7,200V at distribution line ampacity is invariably fatal.
NEC Article 702.6: the legal requirement
NEC Article 702 governs optional standby systems including portable generators. Section 702.6 requires that any connection of a generator to a building's wiring include a listed transfer equipment — a device that physically prevents simultaneous connection of the generator supply and the utility supply to the same wiring system. This is not a guideline or a best practice. It is the National Electrical Code, adopted by all 50 states in some form and enforced by local authorities having jurisdiction.
Compliant transfer solutions:
- Manual transfer panel: a dedicated subpanel with 6–10 circuits that can be switched between utility and generator. Wired by a licensed electrician before the outage. Transfer switch inlet box accepts the generator cord (L14-30 or L14-50 depending on generator rating). Cost: $400–800 for panel and installation.
- Mechanical interlock kit: a plate installed in the main breaker panel that prevents the main breaker and a dedicated generator breaker from being simultaneously closed. Generator connects to the home through a properly rated outdoor inlet box. Licensed electrician installation required. Cost: $50–150 for the interlock + inlet box; $300–600 installation.
- Automatic Transfer Switch (ATS): detects utility outage and automatically switches to generator. Requires electric-start generator with remote start signal. Higher cost ($300–2,000 for ATS + installation).
Related
The generator.transfer_switch_compatible field (boolean) and generator.outlet_types (array) together allow an AI agent to surface the transfer switch requirement — and confirm outlet type compatibility with the buyer's chosen transfer switch — before the generator ships.
Rated watts vs surge watts: the startup stall AI agents cause
Generator output specifications always include two wattage numbers. Many buyers, and many AI agents working from unstructured product descriptions, mistake these for redundant figures or choose between them arbitrarily. They describe different physical phenomena.
| Specification | Also called | What it means | How long |
|---|---|---|---|
| Rated watts | Running watts, continuous | Maximum sustained output indefinitely | Hours |
| Surge watts | Starting watts, peak | Momentary peak for motor starts | 1–3 seconds |
Motor starting surge: the physics
When an AC induction motor starts from a standstill, the rotor is not spinning. The stator's rotating magnetic field attempts to couple with the stationary rotor — but the rotor can't respond instantaneously. During the first fraction of a second, the motor draws locked-rotor current: typically 3–6× the full-load running current. This surge lasts until the rotor accelerates to near-synchronous speed, then current drops to the normal running level.
Startup inrush (4× factor): 40A × 120V = 4,800W startup surge
Refrigerator compressor: 700W running
Startup inrush (3× factor): 2,100W startup surge
Sump pump (1/2 HP): 900W running
Startup inrush (5× factor): 4,500W startup surge
The sizing error
A buyer needs to power a window AC (1,200W running), a refrigerator (700W running), and a sump pump (900W running). Total running load: 2,800W. They purchase a 3,500W rated / 4,375W surge generator — adequate for the running load with margin. The generator runs the refrigerator and sump pump without issue while the AC is off.
The AC is turned on. Startup surge: 4,800W. The generator is producing 2,800W for the running loads already on the circuit. Total surge demand: 2,800 + 4,800 = 7,600W. The generator's 4,375W surge rating is exceeded by 74%. The engine bogs, the AVR cannot maintain voltage, the generator stalls on overload protection. All loads lose power. The sump pump stops while the basement is flooding.
Correct sizing: sum running watts of simultaneous loads, add the largest single motor's startup surge. The combination must fall below surge rating. For the scenario above: 2,800W running + 4,800W AC surge = 7,600W minimum surge required. A correctly sized generator: 6,500W rated / 8,125W surge — providing headroom for the sump pump or refrigerator startup while the AC's compressor is running at full load.
generator.rated_watts and generator.surge_watts encoded as integer fields allow an AI agent to compute whether the buyer's stated load combination fits within generator capacity. Without these as separate structured fields, agents conflate the two numbers from marketing copy ("up to 8,750W!") and recommend undersized units.
EPA Phase 3 and CO Guard 2024: mandatory compliance fields
Two federal regulatory changes took effect in 2024 that determine which generators can legally be manufactured for US sale. Both affect Shopify listings and what an AI agent can responsibly recommend.
EPA Phase 3 (January 18, 2024)
The US Environmental Protection Agency's Phase 3 emissions standards for portable generators tightened HC+NOx (hydrocarbon plus nitrogen oxide) emission limits from the Phase 2 ceiling of 72 g/kW-hr to ≤8 g/kW-hr for engines ≤225cc displacement and ≤16 g/kW-hr for larger engines. This required manufacturers to redesign carburetors, fuel delivery systems, and engine management on most generator lines. Pre-Phase 3 inventory manufactured under Phase 2 certification could be sold through existing dealer stock, but new production entering the supply chain after January 18, 2024 must be Phase 3 compliant.
Shopify stores selling both new Phase 3 units and cleared Phase 2 inventory from pre-2024 manufacturing runs need generator.epa_phase (integer: 2 or 3) to prevent an AI agent from recommending a Phase 2 unit to a buyer who needs Phase 3 compliance for contractor use in jurisdictions that enforce current EPA standards.
California adds CARB (California Air Resources Board) certification requirements stricter than Phase 3. Generators used or sold in California must carry CARB certification. generator.carb_compliant (boolean) is the structured field that prevents recommending a non-CARB unit to a California buyer.
CPSC CO Guard Rule (mandatory from May 14, 2024)
The Consumer Product Safety Commission's CO Guard rule requires all portable generators manufactured for US sale to incorporate automatic carbon monoxide detection and automatic engine shutoff when ambient CO concentration reaches 800 ppm.
The rule came after documented deaths in the thousands. CPSC data shows more than 900 generator-related CO fatalities between 2005 and 2017 alone — most from generators operated in attached garages, in homes with doors open, or just outside open windows. CO is odorless and colorless. At 200 ppm, symptoms begin within 2–3 hours. At 800 ppm — the CO Guard shutoff threshold — incapacitation can occur within 45 minutes. At 1,600 ppm, death can occur within 2 hours. By the time most people recognize CO poisoning symptoms, they are too incapacitated to move to fresh air.
The CO Guard shutoff automatically stops the engine when the CO sensor detects ≥800 ppm — before the operator is incapacitated. The rule's phased implementation:
- May 14, 2021: CO Guard required for new generator models entering the market.
- May 14, 2024: CO Guard required for all portable generators manufactured for US sale — including previously approved models and existing production runs.
generator.has_co_shutoff boolean field and generator.co_shutoff_ppm (800 for compliant units) let an AI agent confirm protection status before recommendation — especially critical for buyers purchasing for household emergency backup use.
CARB independently enforces a complementary rule requiring CO shutoff at 400 ppm for California — stricter than the CPSC 800 ppm federal standard. A generator compliant with CARB's CO rule has a lower shutoff threshold and is safer; a generator compliant only with the CPSC rule at 800 ppm does not meet CARB requirements. The generator.co_shutoff_ppm field captures this distinction numerically.
Complete generator.* metafield namespace for Shopify power equipment stores
The following 16-field namespace covers the structured data needed to prevent all five failure modes above, plus support accurate power sizing and use-case targeting. Encode using Shopify's custom namespace or a product-type-specific namespace. Use integer for whole numbers, decimal for continuous measurements, single_line_text_field for enum strings, boolean for yes/no flags, and list.single_line_text_field for outlet arrays.
// Output specification (waveform quality and power capacity)
generator.rated_watts integer // max continuous output — the sizing number
generator.surge_watts integer // peak 1–3 second output — motor start headroom
generator.output_type text // "avr" | "inverter" — CPAP and VFD compatibility
generator.thd_percent decimal // THD at rated load; ≤3.0 for medical device safe
generator.voltage_v text // "120" | "240" | "120/240" (split-phase)
generator.frequency_hz integer // 60 (US/Canada) or 50 (international export)
// Outlet configuration (connector incompatibility prevention)
generator.outlet_types list_text // ["nema-l14-30","nema-5-20","nema-5-20","nema-tt-30"]
generator.has_240v_outlet boolean // true if any 240V outlet present
generator.transfer_switch_compatible boolean // true if inlet compatible with listed transfer switch
// Physical fuel and engine
generator.fuel_type text // "gasoline" | "propane" | "dual-fuel" | "natural-gas"
generator.tank_capacity_gallons decimal // gasoline tank; omit for propane
generator.run_time_at_50pct_hours decimal // runtime at 50% rated load at rated voltage
generator.engine_displacement_cc integer // engine size — affects EPA Phase 3 tier
generator.electric_start boolean // true if key or remote electric start included
// Safety and regulatory compliance
generator.has_co_shutoff boolean // true if CO Guard auto-shutoff present
generator.co_shutoff_ppm integer // 800 (CPSC standard) | 400 (CARB stricter)
generator.epa_phase integer // 2 or 3 — Phase 3 required in new production 2024+
generator.carb_compliant boolean // required for California sale or use
// Convenience and portability
generator.weight_lbs decimal // dry weight without fuel
generator.noise_db_at_25ft integer // dB(A) at 25 feet at rated load (inverters quieter)
generator.parallel_capable boolean // true if two units can parallel for doubled output
Example product encoding (Honda EU3200i 3200W inverter generator)
{
"generator.rated_watts": 3200,
"generator.surge_watts": 3200,
"generator.output_type": "inverter",
"generator.thd_percent": 1.2,
"generator.voltage_v": "120/240",
"generator.frequency_hz": 60,
"generator.outlet_types": ["nema-l14-30", "nema-5-20", "nema-5-20"],
"generator.has_240v_outlet": true,
"generator.transfer_switch_compatible": true,
"generator.fuel_type": "gasoline",
"generator.tank_capacity_gallons": 1.8,
"generator.run_time_at_50pct_hours": 7.2,
"generator.engine_displacement_cc": 196,
"generator.electric_start": false,
"generator.has_co_shutoff": true,
"generator.co_shutoff_ppm": 400,
"generator.epa_phase": 3,
"generator.carb_compliant": true,
"generator.weight_lbs": 67.0,
"generator.noise_db_at_25ft": 57,
"generator.parallel_capable": true
}
With this encoding, an AI agent can answer: "Is there an inverter generator with a NEMA L14-30 outlet, pure sine wave output for my CPAP, that can start a 1,200W window AC and power a 700W refrigerator simultaneously, and is CARB compliant for California use?" The query requires: output_type = "inverter", thd_percent ≤ 3, outlet_types contains "nema-l14-30", surge_watts ≥ 2800 + 4800 = 7600, carb_compliant = true. The Honda EU3200i fails the surge requirement (3200W surge is below 7600W needed). A Honda EU7000iS (7,000W rated / 7,000W surge, inverter, L14-30, CARB) passes. None of this logic is executable from unstructured product titles.
Related schema guides
- Portable generator outlet and transfer switch compatibility schema — NEMA outlet type table, rated vs surge watts reference, and generator.* namespace specification
- Generator and power equipment compatibility schema — engine types, fuel systems, and power output structured data reference
- ATX power supply schema for AI agents — 12VHPWR fire risk, SFX/ATX form factor incompatibility, 80 PLUS efficiency vs wattage confusion, and psu.* metafields
- EV charger EVSE schema for AI agents — J1772, CCS, CHAdeMO, NACS connector incompatibility, OBC ceiling effect, and evse.* metafields
Does your Shopify store have the generator.* metafields?
CatalogScan checks 18 AI-agent readiness signals across your catalog — including structured data gaps that cause AI agents to recommend generators with the wrong outlet type, missing CO Guard, or inadequate surge capacity for the buyer's actual load.
Scan your store free See Pro features