The information found on this page is intended to give a general overview of the purpose of a catalog and describe ways in which the catalog can be utilized. The catalog view seen here began to be rolled out to Socrata customers in December 2015. Customers using the prior version of the catalog can find information on the Navigating The Dataset Catalog webpage.
- What’s a catalog?
- How can the catalog be used?
- Making the catalog useful
- Tips and additional information
What’s a catalog?
The catalog is a public facing area of an open data website which allows for browsing, searching, and sorting of publicly available assets. Assets on an open data website may include raw, source and federated datasets, visualizations (table, chart, map, data lens, or story) and derived views.
How can the catalog be used?
Public viewers of your open data site will use the catalog to find the datasets and visualizations they need. Using the catalog, users can perform a keyword search1 and filter by a category, view type or topic. Your catalog sorts assets by relevancy (most relevant), access frequency (most accessed), newness to the catalog (recently updated) and most recently updated to allow for efficient and meaningful discovery.
Making the catalog useful
Dataset metadata, such as title and description, play an important role in making your catalog useful to viewers trying to find information on your site. When a viewer performs a catalog search, the search results will display based on a number of factors including metadata, number of views, and frequency of updates. Encouraging data publishers to include thoughtful metadata with their datasets will ensure that viewers get the most of the catalog.
Newly added or updated publicly available assets will show in your catalog within 1 hour of publishing. Keep in mind that datasets with a ‘private’ setting will not be visible, or available, in your public catalog. Should you need to change the privacy settings, you can do so within the “Manage” section of the dataset.
Tips and additional information
- A search can be executed by performing a simple keyword search. Operators, Boolean for example, will not produce results. Results are rendered based on information contained within an asset’s metadata. The order of search results is determined, in part, by the asset’s view count and frequency of updates.
- If your site uses Routing and Approval, assets will not display in the catalog until they have been approved. This applies to content created by any site user.
- Currently, customizations to the catalog are not possible. If you have requests for improvement or feedback, please contact our Support team by emailing email@example.com.
- Does your catalog look different than what’s shown below? Customers using the prior version of the catalog can find information at the Navigating The Dataset Catalog