# dataByGridCleanliness Energy consumption or production, or device operational runtime categorized by the cleanliness of the grid electricity. ``` var dataByGridCleanliness: ElectricityInsightRecord.GridCleanliness? ``` ## Discussion This property returns electricity usage data organized by how environmentally friendly the production of the energy is. The electricity usage data refers to either energy consumption or generation measurements, or amounts of time that an electrical device is operational and consuming energy. The type of the returned value depends on the insight record’s generic type parameter: - [`ElectricityInsightRecord`](/documentation/EnergyKit/ElectricityInsightRecord)<<>> instances return <> for this property. - [`ElectricityInsightRecord`](/documentation/EnergyKit/ElectricityInsightRecord)<> instances return for this property. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)