Introduction

Getting started

The GTFS Editor (or Editor) allows users to edit GTFS feeds imported from the Data Manager (see Loading Feed Versions into Editor) or create GTFS completely from scratch. The following prompt will appear when you first enter the editor (by clicking 'Edit feed').

![gtfs editor welcome screen](../../img/editor-welcome.png)

Editing sessions

Only one editing session per feed source is permitted in order to prevent users concurrently editing data and potentially making incoherent or incompatible changes (e.g., user A adds a pattern stop at position 4 while user B removes a pattern stop at position 4). Because of the highly interrelated nature of GTFS tables locking these sessions is required.

If a second user attempts to edit a feed that with an editing session already underway, they will be locked from editing and must wait until the current user has completed their editing session or choose to override the other editor (this should only be done with care in order not to negatively impact another user's session).

![editor session lock warning](../../img/editor-session-lock.png)

Saving in the Editor

When editing routes, stop, calendars, and any other entities in the Editor, you must manually save any changes using the save icon (💾) button to avoid accidental changes. The only exception here is for patterns, which save your changes automatically.

The primary tables in GTFS (feed info, routes, stops, calendars, and fares) all correspond to items in the lefthand navigation bar, which allow you to create, edit, or delete records for each of these tables.

Some tables are nested underneath these primary tables. Here's how to find them and what they're called in the Editor:

  • Routes
    • Trip patterns (shapes and stop times) - allows users to create one or more stop sequences for a given route. For example, a route may have an inbound and outbound trip pattern.
      • Schedules (trips and frequencies) - define the trips for a trip pattern. Depending on whether the pattern is timetable- or frequency-based, these will be defined as individual trips or frequency intervals.
  • Calendars
  • Fares (fare attributes)

Quick access toolbar

In the bottom, righthand corner of the Editor, you'll find the quick access toolbar that has a few convenient features you might need while editing.

![quick access toolbar](../../img/quick-access-toolbar.png)

From left to right, these functions are:

  • Hide the quick access toolbar
  • Navigate back to feed source or project in Data Manager
  • Upload a zipped routes shapefile to display polylines as a visual aid for drawing trip patterns
  • Create any entity (route, stop, calendar, etc.)
  • Take snapshot (save point) for current state of data (or revert to previous snapshot)

GTFS tables/fields supported

For a technical look at which fields are supported by the Editor, check out this data file which contains a full listing of all of the supported tables and fields in the application.

Are there fields missing that you need? Feel free to contact us at transitrealtime@ibigroup.com to see how we might be able to help.