Add a feed

Why would I want to add or update a feed?

Adding a feed means that more journey planning apps can discover the data and share it with travelers. Service planning tools and researchers also rely on data aggregators like the Mobility Database catalogs to evaluate services and plan future ones. 

To ensure that travelers have access to the most up-to-date information, transit providers should add a new feed on the catalogs when there are major changes to their URL. Examples of changes include:

How do I add or update feed?

There are two ways to update a feed

1. If you're not comfortable with GitHub or only have a few feeds to add: use the form below to request a feed change. The feed will be added as a pull request in GitHub viewable to the public within a week of being submitted. You can verify the change has been made to the catalogs by reviewing this CSV file

In the future, this process will be automated so the PR is automatically created once submitted and merged when tests pass. 

2. If you want to add feeds directly: you can follow the CONTRIBUTING.MD file in GitHub to add sources. 

If you have any questions or concerns about this process, you can email emma@mobilitydata.org for support in getting your feed added. 

Who can add or update a feed?

Anyone can add or update a feed, and it is currently merged manually into the catalogs by the MobilityData team.  The name of the person requesting the feed is captured in the PR, either via their GitHub profile or based on the information shared in the form below.  

In order to verify the validity of a GTFS schedule source, an automated test is also run to check if the direct download URL provided opens a functional ZIP file.