Components of a Data Lens Page

The Data Lens page is organized into three main sections:

  1. Info Pane
  2. Quick Filter Bar
  3. Card Area



Info Pane

The info pane area contains the title and description of the Data Lens page along with other relevant metadata such as the source dataset. This is also where you can download the entire source dataset and access the API that allows you to interact with the dataset outside of the Socrata user interface.

Publishers can use the info panel to set the permission of a Data Lens page as public or private. When in customize mode, the title of the Data Lens page can be edited.

Quick Filter Bar

Use the Quick Filter Bar to view all the selected filters on the data.

If you want to clear out all filters that have been applied, you can do this in the Quick Filter bar as well, simply by clicking the "x" next to the filter description.

Card Area

This is the area of the page where you customize the layout of cards to best present the story of your data. You can add, delete and update cards; rearrange and expand cards as you see fit.

Cards and Types of Cards: The type of data in each column determines the type of card. Most columns will have a visualization card, such as a map or chart, and a search card available to be created.

Column card - This bar chart shows categorical data by row.

Timeline Card - This line chart aggregates the dataset by date.  

Choropleth Map Card - This map aggregates the dataset by regions, such as state or zip code, using the location information. Please note that this feature is not compatible with datasets that have multiple location columns.

Point Map card - This map plots points using location information.

Search card - This is a look up card that allows users to search for a specific value in a column. Note the search card does not filter any location based cards.

Distribution Card - This cards plots number and monetary data, linearly or logarithmically.

Table Card - This card is fixed at the bottom of the data lens page and displays the tabular data.


In addition to the filtering available in the Quick Filter Bar, you can explore cards in the Dataset Card Area through cross-filtering.

Select data in one card, such as a geographic boundary, section of a timeline, or a category on a bar chart and you’ll notice that the data in the other cards adjust based on your selection. Search cards do not filter the other cards, instead they deliver a table with the results to your query.

Axes Rescaling

When performing specific filters on certain datasets, you have the ability to rescale data lens axes.  To enable or disable automatic axes rescaling, check or uncheck the "Rescale Axes on Filter" checkbox accordingly on the top right of the Data Lens customization page.


Exporting Options for Data Lens Components

Rows of data: A csv format of the data can be exported. If there are filters applied to the data lens, users have the ability to download just that filtered data.

Individual cards: Individual cards can be exported as PNG files to easily be used in documentation and presentations. This functionality is available for all end user types.  

To select which card to be downloaded, click Export at the top of the Data lens page and select "Choose card". 

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request



Article is closed for comments.