HomeBlog › Portable generator schema

Shopify portable generator schema for AI agents: backfeed deaths, CPAP pure sine wave, and NEMA outlet incompatibility

Published July 2, 2026 · 10 min read · Generators Power Equipment AI Agents Metafields

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

  1. NEMA outlet incompatibility: L14-30 and L14-50 physically won't mate
  2. AVR vs inverter THD: why CPAP machines need pure sine wave power
  3. Generator backfeed: NEC 702.6, 14,400 volts, and lineworker deaths
  4. Rated watts vs surge watts: the startup stall AI agents cause
  5. EPA Phase 3 and CO Guard 2024: mandatory compliance fields
  6. 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.

NEMA 5-20R
20A, 120V, 2-wire + ground
Standard 120V household loads
NEMA TT-30R
30A, 120V, 2-wire + ground
RV 30A shore power only
NEMA L14-30R
30A, 125/250V, 4-wire twist-lock
Transfer switch, 3,000–8,000W generators
NEMA L14-50R
50A, 125/250V, 4-wire twist-lock
Transfer switch, ≥7,500W generators

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).

Common $200+ return scenario

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.

generator.outlet_types as a JSON array of NEMA designations: the single field that prevents the most common power equipment return in the category.

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 typeTHD (typical)TechnologyCPAP compatible
Conventional AVR3–8% THDDirect alternator → AVR → outputNo — manufacturer contra-indicated
Inverter≤3% THD (1–2% typical)Alternator → DC rectifier → inverter → pure sineYes — meets "utility-equivalent" specification
Utility grid power<5% (IEEE 519 limit)Synchronous generation + transmission filteringYes — 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.

Inverter generator field: 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.

Secondary drives: 240V
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.

Documented outcome: OSHA has investigated multiple generator backfeed fatalities. Criminal manslaughter charges have been brought against homeowners in documented cases. In several incidents, the homeowners were unaware they had created backfeed — they simply connected the generator with a "suicide cord" (male-to-male extension cord) to a dryer outlet, which is sold in hardware stores and is explicitly illegal for this use under NEC Article 702.6.

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:

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.

SpecificationAlso calledWhat it meansHow long
Rated wattsRunning watts, continuousMaximum sustained output indefinitelyHours
Surge wattsStarting watts, peakMomentary peak for motor starts1–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.

Window air conditioner: 1,200W running at 120V = 10A running
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.

2,800W
Running load (all appliances)
4,800W
AC startup surge alone
7,600W
Peak demand at AC start
4,375W
Surge rating of "3,500W" generator — stalls

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.

Structured data for sizing: 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:

Pre-2024 inventory risk: Generators manufactured before May 14, 2024 without CO Guard are not illegal to sell from existing dealer inventory — only to manufacture new. Buyers who assume any new-condition generator has CO Guard may be purchasing pre-2024 stock without the protection. The 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.

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