Our complete Energy dataset is a collection of key metrics maintained by Our World in Data. It is updated regularly and includes data on energy consumption (primary energy, per capita, and growth rates), energy mix, electricity mix and other relevant metrics.

The CSV and XLSX files follow a format of 1 row per location and year. The JSON version is split by country, with an array of yearly records.

The indicators represent all of our main data related to energy consumption, energy mix, electricity mix as well as other indicators of potential interest.

We will continue to publish updated data on energy as it becomes available. Most metrics are published on an annual basis.

A full codebook is made available, with a description and source for each indicator in the dataset. This codebook is also included as an additional sheet in the XLSX file.

The dataset is built upon a number of datasets and processing steps:

• Statistical review of world energy (Energy Institute, EI):
  • Source data
  • Ingestion code
  • Basic processing code
  • Further processing code
• International energy data (U.S. Energy Information Administration, EIA):
  • Source data
  • Ingestion code
  • Basic processing code
  • Further processing code
• Energy from fossil fuels (The Shift Dataportal):
  • Source data
  • Ingestion code
  • Basic processing code
  • Further processing code
• Yearly Electricity Data (Ember):
  • Source data
  • Ingestion code
  • Basic processing code
  • Further processing code
• Energy mix (Our World in Data based on EI's Statistical review of world energy):
  • Processing code
• Fossil fuel production (Our World in Data based on EI's Statistical review of world energy & The Shift Dataportal's Energy from fossil fuels):
  • Processing code
• Primary energy consumption (Our World in Data based on EI's Statistical review of world energy & EIA's International energy data):
  • Processing code
• Electricity mix (Our World in Data based on EI's Statistical Review & Ember's Yearly Electricity Data):
  • Processing code
• Energy dataset (Our World in Data based on all sources above):
  • Processing code
  • Exporting code
  • Uploading code

Additionally, to construct region aggregates and indicators per capita and per GDP, we use the following datasets and processing steps:

• Regions (Our World in Data).
  • Processing code
• Population (Our World in Data based on a number of different sources).
  • Processing code
• Income groups (World Bank).
  • Processing code
• GDP (University of Groningen GGDC's Maddison Project Database, Bolt and van Zanden, 2024).
  • Source data
  • Ingestion code
  • Basic processing code
  • Processing code

• On September 5, 2024:
  • Added per capita electricity demand, from Ember's yearly electricity data.
• On August 30, 2024:
  • Fixed coal electricity generation for Switzerland, which was missing in the original data, and should be zero instead.
• On June 20, 2024:
  • Updated the Energy Institute Statistical Review of World Energy.
  • Fixed issues on electricity data for aggregate regions.
• On May 8, 2024:
  • Updated Ember's yearly electricity data, which includes data for 2023.
  • Updated GDP data, now coming from Maddison Project Database 2023.
• On January 24, 2024:
  • Improved codebook, to clarify whether indicators refer to electricity generation or primary energy consumption.
  • Improved the calculation of the share of electricity in primary energy. Previously, electricity generation was calculated as a share of input-equivalent primary energy consumption. Now it is calculated as a share of direct primary energy consumption.
• On December 12, 2023:
  • Updated Ember's yearly electricity data and EIA's International energy data.
  • Enhanced codebook (improved descriptions, added units, updated sources).
  • Fixed various minor issues.
• On July 7, 2023:
  • Replaced BP's data by the new Energy Institute Statistical Review of World Energy 2023.
  • Updated Ember's yearly electricity data.
  • Updated all datasets accordingly.
• On June 1, 2023:
  • Updated Ember's yearly electricity data.
  • Renamed countries 'East Timor' and 'Faroe Islands', and added 'Middle East (Ember)'.
  • Population and per capita indicators are now calculated using an updated version of our population dataset.
• On March 1, 2023:
  • Updated Ember's yearly electricity data and fixed some minor issues.
• On December 30, 2022:
  • Fixed some minor issues with BP's dataset. Regions like "Other North America (BP)" have been removed from the data, since, in the original Statistical Review of World Energy, these regions represented different sets of countries for different indicators.
• On December 16, 2022:
  • The column electricity_share_energy (electricity as a share of primary energy) was added to the dataset.
  • Fixed some minor inconsistencies in electricity data between Ember and BP, by prioritizing data from Ember.
  • Updated Ember's yearly electricity data.
• On August 9, 2022:
  • All inconsistencies due to different definitions of regions among different datasets (especially Europe) have been fixed.
    • Now all regions follow Our World in Data's definitions.
    • We also include data for regions as defined in the original datasets; for example, Europe (BP) corresponds to Europe as defined by BP.
  • All data processing now occurs outside this repository; the code has been migrated to be part of the etl repository.
  • Indicator fossil_cons_per_capita has been renamed fossil_elec_per_capita for consistency, since it corresponds to electricity generation.
  • The codebook has been updated following these changes.
• On April 8, 2022:
  • Electricity data from Ember was updated (using the Global Electricity Review 2022).
  • Data on greenhouse-gas emissions in electricity generation was added (greenhouse_gas_emissions).
  • Data on emissions intensity is now provided for most countries in the world.
• On March 25, 2022:
  • Data on net electricity imports and electricity demand was added.
  • BP data was updated (using the Statistical Review of the World Energy 2021).
  • Maddison data on GDP was updated (using the Maddison Project Database 2020).
  • EIA data on prima