Feeds are used to either 1) import event content into Localist or 2) export event content from Localist.
Frequently Asked Questions
How often do Feeds import?
Feeds import once a day, overnight EST/EDT. So if you update a Feed during the day, those changes will not be reflected in Localist until the next day.
HEADS UP: While you are able to test Feeds in Staging, they will only import once and will not automatically import each night as they do on your Production platform.
How can you add Localist events to your personal calendar?
We encourage you to add events to your personal iCal, Google Cal, or Outlook Calendar so you’ll never miss out on your org’s happenings. You can subscribe to any Filtered pages or Event Details Pages, so make sure to look out for the calendar icons!
If an event is deleted at the Feed source, will Localist remove it?
Events will not be automatically removed from Localist because there’s no way for our system to know if they have been deleted from the source. So you’ll have to manually delete these events in Localist as well.
If I delete the Feed source out of Localist, will the affiliated events also be deleted?
No. Deleting the Feed URL out of Localist will only prevent the events from further updating in the overnight import. Localist will never delete events without consent.
Who can add Feeds?
Anyone who has User + Platform Admin Permissions.
Exporting a recurring event to an Outlook calendar results in Outlook treating each instance as if they are separate calendars instead of individual events, can this be changed on Localist’s end?
Localist cannot change this behavior as the ICS file generated is formatted properly. When exporting a recurring event from Localist to Outlook, Outlook treats each instance as a separate calendar instead of individual events.
Can HTML be included in Feed descriptions for import?
Yes, our parser accepts the following HTML tags:
<strong>, <em>, <b>, <i>, <p>, <code>, <pre>, <tt>, <samp>, <kbd>, <var>, <sub>, <sup>, <dfn>, <cite>, <big>, <small>, <address>, <hr>, <br>, <div>, <span>, <h1-h6>, <ul>, <ol>, <li>, <dl>, <dt>, <dd>, <abbr>, <acronym>, <a>, <img>, <blockquote>, <del>, <ins>, <iframe>, <u>.
If events have been manually added via the Event Forms but the same event exists in a Feed I’m trying to import, will they automatically match in Localist?
No. Events in Feeds are seen as unique and will not match up with events added through other means (such as bulk-add or via the event forms).
These feeds are configured by Platform Admins directly in the Admin Dashboard.
- ICS — these feeds adhere to the iCalendar standard. ICS includes feeds from, but not limited to, iCal, Outlook, Exchange, Google Calendar, Presence, SideArm, Trumba, OrgSync and CollegiateLink.
- RSS — these feeds adhere to the hCalendar standard. Since RSS is inherently unstructured in terms of event dates, descriptions, etc., Localist needs specific tags to be able to successfully import. RSS includes feeds from, but not limited to, ActiveData.
- CSV — these feeds are CSV (.csv) or Excel (.xls) files hosted on your servers as a feed. The file must adhere to the same CSV format used for bulk uploading. CSV feeds also include, but are not limited to, Google Drive Sheets.
- Eventbrite — Localist will connect directly to Eventbrite through your admin dashboard for set up.
- EMS — events are imported through the EMS API.
- SeatGeek — events are imported through the SeatGeek API.
- Cvent — events are imported through the Cvent API.
- SimpleView — events are imported through the SimpleView API.
|Venue Page Only||✓|
*RSS Location must use proper hCal tags to be imported.
- Non-hCal location: Event at Location: <title>Senior Concert at Arts Center</title>
- Location properly using hCal: <span class=“location”>Arts Center</span>
Feed Statuses: After each import, the feed overview page will note the following details:
- Status (complete, etc.)
- Date and time of import
- Number of events imported
- Number of pending events
- Number of rejected events
If an event has been rejected, there will be a link to see the exact errors per event.
Adding a Feed
In the Admin Dashboard, navigate to Events > Feeds
On this page you will see all live feeds. To create a new feed, select +Add Feed in the top right corner.
Enter a Name and the URL for the Feed
The Name should be a general description easily recognizable by other admins.
HEADS UP: If you need to change the URL in the future, ensure that the content remains exactly the same at the source to avoid losing or duplicating events.
Apply additional settings
- Skip Pending Queue: Events will go live directly to the platform at each import
- Overwrite Schedule: If the date changes at the source, it will replace the current schedule in Localist.
- If checked: Event A on Oct 1 is imported —> Upon next import Event A is now listed for Oct 2 and Oct 1 is no longer present in the feed —> The live event in Localist is updated from Oct 1 to Oct 2
- If not checked: Event A on Oct 1 is imported —> Upon next import Event A is now listed for Oct 2 and Oct 1 is no longer present in the feed —> The live event in Localist is updated to now have two instances – both Oct 1 and Oct 2. Essentially, this functionality is only applied to instances of events that are still in the feed. If an entire event is remove from the feed then Localist will not make any updates or deletions and the event will stay in the last-imported state unless manually modified.
- Don’t Update Filters: If checked, Content Overrides will only be applied upon the event’s first import. This means that you can apply a general override to the entire feed then apply specific filters on an individual basis without the Content Override replacing the specific filters after the next import.
Apply Content Overrides (optional)
These will be applied to every event in the feed.
Include authentication details
If your feed requires an authenticated user to access it, enter the Username and Password
Upon saving, the feed will initially import once. After the initial import, the feed will import once a day overnight. This time cannot be changed and updates will not be reflected in Localist until the nightly import. HEADS UP: Past events are not imported.
Important Feed Import Details
Feed Data Takes Precedent
1. Data imported by a feed into Localist will always take precedent over data that has been added or updated in the Localist event. Only the following 3 details can be locked and cut off from further feed updating (admins will still be able to manually update these fields and their updates will continue to remain locked):
- Event Place
2. All other details that are brought in via a feed must be changed at the feed source. If it is changed in any way in Localist then the changes will only stick until the next feed import, at which time it will revert back to the data in the feed.
- Exception: If a piece of data is not provided by the feed then any changes or additions in Localist will stick even after the next import. For example, if the feed only provides name/date/time/description/place then anything else, such as a tag or custom field, will remain as updated in Localist.
3. If fields in a feed match fields in Localist then the data must match exactly to what is saved in Localist. It is not possible to assign aliases or alternative spellings. For example, place names must match the place landing pages and filters must match your platform’s existing classification scheme in order to connect properly.
Deleting a Feed Event
1. Deleted in Localist: If an event has been imported to the calendar then deleted, it will reappear if it is sent back over through the feed. Since feed data takes precedent, if the event is present in the feed then it will be re-added to Localist.
- Exception: If an event is rejected from the pending queue then it will not re-appear. If the event is deleted while still in the pending queue then it will be re-imported into the queue.
2. Deleted at the feed source: If an event is removed from the feed source, the event in Localist will not be removed. This is because it is impossible for Localist to determine whether the event has been deleted/cancelled or if the event is just not present in the feed. In this case you will need to delete the instance in the feed and in Localist.
Creating Custom CSV Feeds
If you have the technical know-how, you can create a Custom CSV Feed to ensure the most amount of event data is imported into Localist. To get started, use our Bulk-Add documentation for insight on which headers to use, and how to format them.
While the Localist team are not experts on building feeds, here is what we can assist with vs what your internal team will need to troubleshoot should you hit any snags:
Assistance from Localist
- Headers: We can provide the headers necessary for the CSV file to use
- Data Formatting: We’re able to provide insight on how to format data (i.e. how to format the date)
- Content Overrides: We can provide insight on how to apply Content Overrides to the Feed on import
- Error Messages: If you’re getting errors in Localist, we can assist with troubleshooting
Resolved by Customer Team
- Building Feeds: Your team will need to work internally on how to build the feed, and the code necessary to accomplish it
- Hosting: Your team is responsible for hosting the feed at a permanent URL for importing into Localist
- Non-Imported Data: If an event or specific details aren’t present in the imported Feed, your team will need to investigate at the Feed’s source and/or review how data is set up to be imported in the Feed.
- Duplicates and Updates: If duplicates are imported, or an event did not properly update, you’ll need to investigate at the Feed’s source.**
**Note: There are some instances where Localist can provide confirmation on what’s happening if duplicates are created, or why events did not update in the overnight import. If you provide the name or URL to events in question, we’re happy to help look into it. That said, we cannot suggest specific changes that should be made to the Feed to correct this.
– HEADS UP –
Here are some helpful troubleshooting tips to try before you reach out to the support team!
- Localist is rejecting the Feed URL: You should always check your Feed’s validity if you are experiencing any issues here. We recommend using a Feed validation service like, https://validator.w3.org/feed/.
- Past Events were not imported: You can only import Feeds with future Events into Localist. So, always make sure that your Feeds do not have any past Events.
- Content is not importing as expected: You can apply additional settings, such as Content Overrides, to your Feeds in Localist. If you’re hitting a roadblock with a Feed, make sure that all of these settings are set up correctly.
- Changes haven’t been reflected in Localist: Localist Feeds update once overnight — if you make any changes to your Feeds during business hours they will not update until the next day.
- Feed settings are not saving in Localist: Double check that the Feed you’re setting up is not empty as empty Feeds are invalid. The settings not saving is the expected behavior of Feeds that do not pass validation.
- ICS & RSS — these feeds adhere to the iCalendar standard and hCalendar standard respectively and are available throughout the platform for automatic exporting via URLs. Localist provides specific Apple Cal, Google Cal and Outlook feeds to trigger each application when available.
- JSON — the Localist API provides all available event data in JSON.
- CSV — this can be generated through the Localist API and it will be a static file, not a feed.
ICS & RSS
Subscribed feeds cover 12 months
The first 1,000 events in that date range. For example, if there are 1,000 events in the first 6 months then the feed’s initial pull will only cover that date range.
- Start time
- End time (ICS only)
- Category (Event Types in Localist)
- Location (RSS appends this to the end of the title, such as Senior Concert at Arts Center)
- Room Number (ICS only)
Where to find these feeds:
- All Events or Filtered Results: On every filtered results page you’ll find the subscription options in the Filter dropdown. The export options are located in the Subscribe to Displayed Results section of the dropdown.
- My Calendar: To subscribe to the events you’ve marked yourself as I’m Interested in, navigate to your User Dashboard > My Calendar and the subscription options will be located in the Filter dropdown.
- Group or Place Landing Pages: When on the landing page, select View Full Calendar… then use the Filter dropdown.
Google Calendar Details
- Exporting Multiple Events: If exporting a filtered results page, Gmail will prompt you to add a new calendar.
- Exporting Individual Events: If exporting from an individual event landing page, Gmail will open a regular Create form pre-populated with the available data.
- HEADS UP: If the event is recurring and includes several instances then Google will only add the first instance.
Outlook interprets data differently depending on where the iCal feed is exported:
- Outlook doesn’t allow subscribing to an ICS file with multiple events, such as a the “All Events” page or selecting a Filter Item. Events will be added, but they will not be connected so the events won’t update to reflect future changes. If you copy the link to the ICS file and manually subscribe to it in Outlook then the events will be added and updated accordingly.
- Windows Outlook handles importing an ICS file with one event in the ICS adds a single event to a calendar, but multiple events in the ICS as a new calendar. The ICS we generate for a single event always contains all instances of the event so it’s up to the calendar program how it’s imported.