SA Cities Open Data AlmanacBETA
Partners in City Development Strategies

How to Use the Portal

The website is an open data portal that has been designed to be easy to access and download key data. The core dataset is the State of Cities Report 2016 Almanac which contains over 400 indicators of city performance.

SCODA offers three main ways to access the data:

The Portal
The Portal allows users to download full datasets for the SoCR Almanac as well as other key data sets. Data can be downloaded as a Microsoft Excel file or as a csv file. Over time, all data sets generated by the SACN will be made available to download here.

  • Three options for download are available:
    1. Full Almanac download, including metadata
    2. Download per SACN theme (demographic data, productive cities, inclusive cities, sustainable cities and well-governed cities)
    3. Download of per-City Dashboards (PDF posters as per the 2016 State of Cities Report)
  • Additional data sets loaded as available, such as data generated for the Productive Cities chapter of the SOCR 2016; data from the 2015 State of City Finance report; and data from the State of Urban Safety Report 2016.

Data visualisations (infographics)
The Indicators button allows users to explore 12 key city indicators as interactive infographics. Each infographic contains an explanation of the indicator as well as reference to where the data was sourced. All of the data for these Indicators is contained within the Almanac

The Map highlights the Cities whose data is contained within SCODA as well as key data. The SACN, through a partnership with the CSIR, has also supported the development of more detailed spatial analyses and visualisations of city development which are available at:



Member Cities Map


The South African Cities Open Data Almanac or SCODA is a city-centric data portal that aims to support the planning, management, monitoring, and reporting needs of cities. With the fast-changing and increasingly complex dynamics of contemporary South Africa where the majority of people now live in cities, monitoring how cities are planned and managed is important. Indicators are critical to effective planning and management in urban contexts, organising information sets into simpler, and easier to understand and compare ‘measures’ of what is happening. Good urban indicator sets allow for a longitudinal perspective (i.e. change over time) and comparisons between cities locally and internationally, enabling cities to see whether or not they are adequately achieving their objectives. SCODA contains data and indicators organised around key thematic areas:

  • Productive cities
  • Inclusive cities
  • Sustainable Cities
  • Well-governed cities
  • City demographics

Each theme has a set of core and secondary indicators.

SCODA is run by the South African Cities Network (SACN), an established network of South African cities and partners that encourages the exchange of information, experience and best practices on urban development and city management. The SACN has published State of South African Cities Reports (SoCR) since 2004, and these reports present a 5-year perspective on the performance and conditions of South Africa’s largest cities, with a focus on the SACN member cities. The SoCR process has always included a data almanac section, and long-envisaged having an online data portal that allows access to up-to-date data and indicators that are important to cities.

The SCODA site now provides a framework to enable an ongoing process of making city data accessible. Through a partnership with the World Council for City Data, SCODA also seeks to align to the ISO 37120 Standard on City Indicators so that South African cities can learn from global practice, and also benchmark themselves against international peers.

Further information about the development of SCODA is available at

Photo Acknowledgements
Photos used on this site are from the 2015 SACN Instagram competition and we acknowledge the photographer, by the indicator and their instagram handle: People and Households: @amzbooysen; Cities over time: @moography; Population pyramids: @greg_alexander; Economic growth: @gavman18; Unemployment: @justjozi; City finance: @raeharrison1984; Non-revenue water: @pandanicoleium; Access to electricity: @ishotimagesza; Access to sanitation: @kojobaffoe; Education: @dane_forman; Urban Crime index: @iamsoweto; Sources of energy 2011: @drae_savvides.

Other Important Links