OpenBlock is a web application that allows users to browse and search their local area for "hyper-local news" - to see what's going on recently in the immediate geographic area.

Brief Overview: Concepts and Terminology

OpenBlock is a hyperlocal news platform. What we mean by that is that, at its essence, OpenBlock is a web application (and web service) that stores two kinds of information:

  • Local news. What's happening nearby? This could be your original content, or aggregated from any number of sources on the web.
  • Local geographic data. What places do we care about? Neighborhoods, zip codes, school districts, police precincts?

OpenBlock allows you to explore that data in various ways: by geographic area, small or large; by type of news; by various categories relevant to the types of news you have; by text search; or by any combination of the above.

News in OpenBlock is stored as NewsItems. In essence, a NewsItem is just something that happened at one time and one place. Each NewsItem stores a timestamp, a geographic point, a title, a description, and a few other generic fields.

Each NewsItem also has a type, which we call its Schema. Schemas are used to classify NewsItems and allow them to have extra searchable, type-specific data.

For example: an OpenBlock site might provide both police reports and restaurant inspections. There would be one Schema representing police reports, allowing each police report to store information about what kinds of crime were committed. There would be a second Schema representing restaurant inspections, and it would allow each inspection report to say whether the restaurant failed or passed, what violations were observed, and so on.

All this can be configured by the site administrator without writing code.

A user is then able to browse NewsItems that are only police reports, or only restaurant inspections, or both; or browse only failed restaurant inspections; or browse crimes of a certain type, in a certain location, during a certain time period; et cetera.

There is a demo site where you can experiment with similar searches.


OpenBlock began life as the open-source code released by in June 2009. Originally created by Adrian Holovaty and the Everyblock team in 2007, it has been rebranded OpenBlock to avoid trademark infringement, and is now developed as an open-source (GPL) project at

Funding for both the initial creation of Everyblock and the ongoing development of OpenBlock was provided by the Knight Foundation.

For Developers

This is a Django application, so it's highly recommended that you have familiarity with the Django Web framework. The best places to learn are the official Django documentation and the free Django Book.

Before you dive in, it's highly recommended you spend a little bit of time browsing around and/or to get a feel for what this software does. (But note that the code has diverged considerably since 2009, so has features not present in OpenBlock, and vice versa; the visual design is quite different as well.)

Also, for a light conceptual background on some of this, particularly the data storage aspect of ebpub, watch the video "Behind the scenes of" here:

All Contents

Indices and tables