This module provides the necessary tools and configurations to report election results within the LocalGov Drupal distribution. It supports various election types and offers different ways to visualize the results, with an extensible system for electoral area data.
This module provide content types, views and configuration that allow the reporting of election results for the LocalGov Drupal distribution.
Features
First past the post single seat per electoral area elections
'All-out' and not 'all-out' (e.g. halves or thirds) elections
Table, graph and map based views of the results
Extensible boundary source provider for electoral areas and geo data
How to use
See the Documentation for more details
Installing
You can install this module with the following composer command.
composer require drupal/localgov_elections
Upgrading from 2.x to 3.x
The 3.x branch removes the dependency on drupal/charts and charts.js
To upgrade localgov_elections, you might need to composer require drupal/charts to allow you to uninstall charts manually.
For example.
composer require 'drupal/charts:^5.2'
composer require 'drupal/localgov_elections:^3.0@beta'
drush updb
To uninstall drupal/charts, you might also need to reset the configuration to default.
To do this, visit the charts configuration page at /admin/config/content/charts
At the bottom of the form, click on the button to "Reset to default configurations".
If nothing else depends on charts, you should now be able to uninstall it at /admin/modules/uninstall
Or using drush with:
drush pmu charts
If you have any problems upgrading, do please report it in the issue queue.
Libraries
The libraries required by Charts/Highcharts are included, by default via CDN. If you wish to have these locally follow the instructions at https://www.drupal.org/docs/contributed-modules/charts/50x-getting-start... which uses the composer.json provided by the Charts module to install.
Submodules
You may also wish to use the submodules provided as part of the Localgov Election Reporting module. They are:
- LocalGov Elections Reporting ONS Wards 2023 - Boundary source provider for Office of National Statistics 2023 District Wards - DEPRECATED
- LocalGov Elections Reporting ONS Wards 2023 - Boundary source provider for Office of National Statistics 2023 District Wards
- LocalGov Elections Reporting ONS Divisions 2024 - Boundary source provider for Office of National Statistics 2024 County Divisions
- LocalGov Elections Reporting ONS Parishes 2024 - Boundary source provider for Office of National Statistics 2024 Parishes
- Localgov Elections Parliamentary Constituency Provider - Boundary source provider for Office of National Statistics 2024 constituency boundaries
- LocalGov Elections Reporting Demo - Demo content to help with testing/evaluation
- LocalGov Elections Reporting - UK Parties - Adds the majority of UK political parties to the party taxonomy.
Further details for these modules are in their own module READMEs and the Documentation.
Issues
If you run into issues using this module, please report them here on drupal.org.
Known issues
Node Revisions
Revisions do not currently work with the 'Areas vote' content type. We have implemented a work around to mitigate the situation by preventing the creation of revisions for the candidate paragraph entities.
For the time being, we suggest not using attempting to use revisions with 'Areas vote' nodes.
If you have Localgov Workflows turned on, it will enable 'Create new revision' by default. This should not be a cause for concern, as the problematic candidate paragraphs are being forced to ignore revisions.
If you have any questions or problems, please ask in the #feature_elections channel in the LocalGov Drupal Slack channel.
Depends on
Dependencies of the latest stable release
- Autocomplete Deluxe
- Color Field
- Field Formatter Class
- Geocoder geocoder_field
- Geocoder geocoder_geofield
- Geofield
- Leaflet
- Leaflet leaflet_views
- LocalGov Core
- LocalGov Paragraphs
- Paragraphs table
- Views Field View
- block Drupal core
- datetime Drupal core
- field_group Drupal core
- file Drupal core
- link Drupal core
- menu_ui Drupal core
- node Drupal core
- options Drupal core
- path Drupal core
- pathauto Drupal core
- taxonomy Drupal core
- toolbar Drupal core
- views Drupal core
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.
Activity
Release Timeline
Releases
| Version | Type | Core | Notes | Release date | |
|---|---|---|---|---|---|
| 3.3.3 | Stable | 10–11 | Jul 14, 2026 | ||
| 3.3.2 | Stable | 10–11 | May 12, 2026 | ||
| 3.3.1 | Stable | 10–11 | May 7, 2026 | ||
| 3.3.0 | Stable | 10–11 | May 6, 2026 | ||
| 3.2.1 | Stable | 10–11 | May 5, 2026 | ||
| 3.2.0 | Stable | 10–11 | Apr 30, 2026 | ||
| 3.1.0 | Stable | 10–11 | Bug fixes, multiple previous winners, deploy hook for missing party details | Apr 29, 2026 | |
| 3.0.0 | Stable | 10–11 | Apr 13, 2026 | ||
| 3.0.0-beta1 | Pre-release | 10–11 | Apr 9, 2026 | ||
| 3.0.0-alpha1 | Pre-release | 10–11 | Mar 24, 2026 | ||
| 2.1.0-beta2 | Pre-release | 10–11 | Mar 17, 2026 | ||
| 3.x-dev | Dev | 10–11 | Feb 9, 2026 | ||
| 2.x-dev | Dev | 10–11 | Feb 3, 2026 | ||
| 2.1.0-beta1 | Pre-release | 10–11 | Update composer namespace for drupal.org | Dec 1, 2025 | |
| 2.0.0-beta1 | Pre-release | 10–11 | Sep 4, 2025 |