---
description: >-
  Guide for public dashboards and data visualization for the City and County of
  San Francisco.
---

# Data visualization standards for SF.gov

## These guidelines outline best practices for public reporting of data dashboards and visualizations.&#x20;

This guide was created collaboratively in 2021 by DataSF, Digital Services, Controller’s Office, and several expert volunteers.

We aim to ensure data visualizations created for the public are:

* Thoughtfully designed
* Accessible and enjoyable
* Mobile-responsive

For dashboards or data visuals going on a public website, implementing these guidelines should be considered a minimum criteria for your dashboard or product.

## This guide is for analysts publishing visuals to the **public.**

This guide is for data analysts experienced in data visualization who plan to publish dashboards or data visuals on a public website. While this guidance is applicable for any website, following this guidance is required for any visuals going on the SF.gov platform.

Nonetheless, many of the accessibility best practices are relevant and can be applied to internal reports as well.

Take a look at [our gallery of dashboard transformations ](gallery-of-dashboard-transformations)once these rules have been applied. You can also [read more about how this guide was developed in a blog article](https://medium.com/san-francisco-digital-services/a-template-for-accessible-data-visualizations-ca2ed52f945bhttps://medium.com/san-francisco-digital-services/a-template-for-accessible-data-visualizations-ca2ed52f945b).

## Power BI resources

If you are using Power BI, [use our template PBIX file](using-the-power-bi-template) and associated video tutorial and step-by-step guide . All the guidance below is already applied to our template, so it’s easy to just plug in your data and go!&#x20;

<div align="left"><img src="https://500103827-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Me6UpceLwq_2RueSmwS%2F-MfjZ-xIla-ojEncWll9%2F-MfjcLSX8w2rKkcf_5Ch%2Ftemplate%20pic.JPG?alt=media&#x26;token=4f133c99-da9e-408e-b9a3-4cda4a278857" alt="Screenshot from our Power BI template file, highlighting the contents: there are several layout options, built-in spacers to help move and organize visuals, all formatting standards are built in, alt text and tab order are correct, and a date table and other advanced measures are also included."></div>

:pushpin: **Power BI-specific tips** are highlighted throughout this document.

You should use this guide in concert with [DataSF’s Power BI resource library](https://datasf.org/resources/power-bi/).

Analysts can use any visualization software approved by their Department, and all of this same guidance applies.

## Thank you!

This guide is only possible because of countless amazing articles, blog posts, and presentations on dashboarding, accessibility, and design. Thank you to the engineers, designers, accessibility experts, and other leaders that contributed to this work simply by publishing excellent resources elsewhere. Check out [our resources section](more-resources-1) to find a list of resources we used.

Special thanks to several expert designers and engineers who worked on this guide and the corresponding Power BI template. Thank you to:

* [Jaime Tanner](http://www.jaimetanner.com/)
* [Frank Elavsky](https://twitter.com/frankelavsky?lang=en)
* [Chris Demartini](https://github.com/demartsc)

For Power BI implementation, we leaned heavily on the work of [Meagan Longoria](https://datasavvy.me/about/). Check out her [Power BI checklist,](https://datasavvy.me/2018/06/06/power-bi-report-accessibility-checklist/) and [webinar on accessibility](https://powerbi.microsoft.com/en-us/blog/6-7-webinar-building-accessible-power-bi-reports-by-meagan-longoria/).
