---
title: EnergyKit
framework: EnergyKit
role: collection
role_heading: Framework
platforms: [iOS 26.0+, iPadOS 26.0+]
path: energykit
---

# EnergyKit

Provide grid forecasts and energy insights to help people optimize their electricity usage.

## Overview

Overview EnergyKit provides grid forecasts and energy insights to help people view their energy consumption patterns and choose when to use electricity at home. The framework delivers personalized forecasts for a home based on grid cleanliness and electricity rates, when available, enabling apps to optimize device operation for environmental impact and cost. Use EnergyKit to build apps that manage home device electricity usage and support the transition to a cleaner electricity grid. You can use the framework for residential, metered locations such as smart thermostats (HVAC), and for electric vehicle charging.

Using EnergyKit, your app can: Receive grid forecasts that identify when cleaner electricity is available and when electricity rates are lower, when rate plan information is available. Submit electrical load events that track device energy consumption during operation and provide data for the Home app. Request insights about a customer’s historical electricity usage correlated with grid cleanliness and electricity rate periods. Display rich activity logs and analytics in the Home app without building custom statistics or graphing UI. Receive energy guidance and submit energy use The framework provides two complementary workflows: The ElectricityGuidance structure identifies optimal times for electricity usage based on grid cleanliness and utility rates. Use this guidance to optimize when your managed devices consume electricity. Submit ElectricVehicleLoadEvent and ElectricHVACLoadEvent instances that track energy consumption during device operation. Optionally submit ElectricVehicleStatusEvent instances that explain charging behavior and support informative activity logs in the Home app. important: Energy guidance is only available in the contiguous United States. To use EnergyKit, the system requires your app to have the EnergyKit Entitlement entitlement with a value of true. Display energy data in the Home app When you adopt the EnergyKit LoadEvents Entitlement, the Home app displays your electrical load events in a unified energy experience. The Home app shows: Historical charts with up to five years of energy data Activity logs that explain device behavior with timestamps and reasons Monthly trend notifications about energy usage patterns Whole-home energy overlays when people connect their utility account This integration eliminates the need to build custom analytics UI, while providing a consistent experience across all energy devices in a person’s home.

## Topics

### Essentials

- [Optimizing home electricity usage](energykit/optimizing-home-electricity-usage.md)
- [Providing charging history for electric vehicles](energykit/providing-informative-charging-history-for-electric-vehicles.md)
- [EnergyKit Entitlement](bundleresources/entitlements/com.apple.developer.energykit.md)
- [EnergyKit LoadEvents Entitlement](bundleresources/entitlements/com.apple.developer.energykit.loadevents-experience.md)

### Electricity guidance

- [ElectricityGuidance](energykit/electricityguidance.md)

### Electric vehicle events

- [ElectricVehicleLoadEvent](energykit/electricvehicleloadevent.md)
- [ElectricVehicleStatusEvent](energykit/electricvehiclestatusevent.md)
- [ElectricVehicleChargingReason](energykit/electricvehiclechargingreason.md)

### HVAC events

- [ElectricHVACLoadEvent](energykit/electrichvacloadevent.md)

### Device identification

- [ElectricalLoadDevice](energykit/electricalloaddevice.md)
- [ElectricalLoadEventProtocol](energykit/electricalloadeventprotocol.md)

### Energy venues

- [EnergyVenue](energykit/energyvenue.md)

### Electricity insights

- [ElectricityInsightService](energykit/electricityinsightservice.md)
- [ElectricityInsightQuery](energykit/electricityinsightquery.md)
- [ElectricityInsightRecord](energykit/electricityinsightrecord.md)
- [ElectricityInsightMeasure](energykit/electricityinsightmeasure.md)

### Supporting types

- [ElectricityFlowDirection](energykit/electricityflowdirection.md)
- [EnergyKitError](energykit/energykiterror.md)