Fan

Entity ids in this domain look like fan.<object_id>.

Use in preferencesCopy Anchor Link

{ key: 'device', label: 'Device', type: 'entity', domainFilter: 'fan', required: true }

StatesCopy Anchor Link

getState() returns the raw token. subscribe filters, entity.is() and matchesState() also accept the friendly label the app shows (any case; spaces, hyphens and underscores interchangeable).

subscribe($g.device, { to: 'on' }, onChange);
subscribe($g.device, { to: 'On' }, onChange); // same thing, by label
if ($g.device.is('On')) { /* … */ }

ServicesCopy Anchor Link

Curated for smart apps (also offered by the wizard action catalog):

await $g.device.setPercentage({ percentage: 100 });

Also routable (FanServices), not in the wizard catalog — callable as entity.<service>(); the integration may reject unsupported ones at runtime:

oscillate, setDirection, setPresetMode

FeaturesCopy Anchor Link

Bitmask on the supportedFeatures attribute; read the values with getEntityFeatures().Fan.