Skip to content
Contact us
  • There are no suggestions because the search field is empty.

Troubleshooting Veracross Syncing

Resolve common problems with events not appearing correctly

Overview

This guide helps you diagnose and resolve issues when Veracross events are missing from Google Calendar, appearing incorrectly, or showing at the wrong times. Most syncing issues fall into three categories: timing of syncs, missing class data in Veracross, or limitations with specific course types.

How to Diagnose Syncing Issues

  1. Check when you last ran a sync in SchoolCal
  2. Identify the specific problem: Are events missing entirely, appearing when they shouldn't, or showing at incorrect times?
  3. Note which classes or course types are affected
  4. Follow the troubleshooting steps below based on your specific issue

Additional Info

Google's Event Creation Limit: Google Calendar has a limit of 100,000 events per sync. You can view your current event count in SchoolCal's sync interface.

Veracross API Versions: SchoolCal uses both Veracross API V2 (for basic syncing) and V3 (for alternate block schedules). These must be configured separately.

Course Types in Veracross: Events are categorized as Academic, Non-Academic, Advisory, Homeroom, Athletic Program, Other Programs, Extended Care, Dorm, or Summer. Different course types have different syncing capabilities.

Troubleshooting

Events Haven't Synced Recently

If you notice changes in Veracross that aren't reflected in Google Calendar, check when you last ran a sync. Changes made in Veracross after your most recent SchoolCal sync won't appear in Google Calendar until you sync again.

Solution: Run a new sync in SchoolCal to pull the latest data from Veracross.

All Events Missing for Certain Classes

If entire classes are not appearing on Google Calendar, this is likely because those classes are missing start and/or end dates in Veracross. SchoolCal requires both dates to create events on Google Calendar.

Solution: Add start and end dates in Veracross for any classes you want to sync to Google Calendar.

Some Events Missing Across Multiple Classes

If you're approaching Google's 100,000 event creation limit, SchoolCal may not be able to create all events. Check the event count displayed in SchoolCal's sync interface (shown on the right side).

Solution: Use the "Meeting dates" filter to reduce the number of events by only syncing events that occur on or before a specific date.

Dorm Events Appearing on Faculty Calendars

If events with the course type "Dorm" are appearing when they shouldn't, this is caused by a bug in Veracross' API. Dorm events from the API are missing their course type designation, making it impossible to filter them out by course type.

Solution: Filter out events by faculty role instead—exclude the "Dorm Head" and "Dorm Parent" roles to prevent dorm events from appearing on faculty calendars.

Note: There is currently no way to prevent dorm events from syncing to student calendars.

Event Times Incorrect for Academic-Type Classes on Alternate Schedule Days

If events show at the wrong time on days with an alternate block schedule, and the course type is Academic, Non-Academic, Advisory, or Homeroom, you may not have fully enabled alternate block schedule syncing.

Solution: Alternate block schedule syncing uses Veracross API V3 and must be configured separately from the V2 sync. Verify that your V3 API connection is properly set up in SchoolCal.

Event Times Incorrect for Athletic/Program-Type Classes on Alternate Schedule Days

If events show at incorrect times on alternate schedule days, and the course type is Athletic Program, Other Programs, Extended Care, Dorm, or Summer, this is a known limitation.

Explanation: Veracross API V3 does not yet support alternate block schedules for these course types. These events will appear at their regularly scheduled times, even on alternate schedule days.

Events Not Syncing to Student Calendars (But Faculty Calendars Are Working)

If events are syncing correctly to faculty calendars but not appearing on any student calendars, and you have already turned off SchoolCal Pilot Mode, this is likely because portal schedules are not enabled for the affected grade level(s) in Veracross.

Solution: Check the "Enable Portal Schedules" field in the Veracross Grade Levels query and enable it for the grade levels that need calendar syncing. Refer to Veracross' documentation for more details on enabling and disabling student schedules.