Official Site of The State of New Jersey
Staff Vacancy User Resources
This page contains the core tools you need to complete your Staff Vacancy submission in NJSLEDS. Each resource below is designed to guide you through a specific part of the process—from understanding field rules to formatting your file. For additional help and resources, visit the Key Documents page, or contact the NJSLEDS Help Desk.
| Resource | Description | Type | Updated |
|---|---|---|---|
| Staff Vacancy Data Handbook | Field definitions, validation rules, and submission structure | Mar 23, 2026 | |
| Submission Template A | Includes headers and lookup values | Excel | Mar 23, 2026 |
| Submission Template B | Header row only | Excel | Mar 23, 2026 |
| Webinar Slides | Submission process walkthrough, key reminders, and common errors | Apr 16, 2026 | |
| Frequently Asked Questions | Common questions about submission timing, field issues, and file errors | Mar 16, 2026 |
Choosing the Right PositionType
Staff Vacancy reporting covers teaching positions only. It captures vacancy activity for those positions, so you create a record only for a teaching position that was vacant, newly created or eliminated. You do not create a record for every filled position, and you do not report non-teaching staff in this collection. The roles that qualify as teaching positions are defined by the valid job codes in the Job Codes and Job Code Subcategories document.
PositionType tells NJSLEDS what kind of activity each record represents. There are four valid values.
| Value | What it means | When to use it |
|---|---|---|
| 1 | No vacancies to report | The school has no vacant, new or eliminated positions to report for this submission. Use a single record and leave all other fields blank. |
| 3 | New Teaching Position | A teaching position that did not previously exist was created, for example because of enrollment growth or a new program. |
| 4 | Eliminated Position | A full-time teaching position will no longer be encumbered in future school years. Staff may be reassigned, so this does not necessarily reduce your staff count. DistrictPositionID is not required for eliminated positions. |
| 5 | Vacant Position | A full-time position has no incumbent teacher and is open for filling. |
Note: PositionType 2 (Anticipated Retirement) was retired and is no longer a valid value.
PositionType 1 means “nothing to report”
PositionType 1 is a single placeholder that tells NJSLEDS a school had no vacancy activity for this submission. It is not a per-position code, so you do not need a PositionType 1 record for each teacher, each filled position or each role in the school.
- If a school had no vacant, new or eliminated positions, submit one PositionType 1 record for that school and leave JobCode, JobCodeSubcategory, DistrictPositionID, PositionOpenDate and PositionClosedDate blank.
- If a school did have vacancy activity, report those positions using PositionType 3, 4 or 5 and do not include a PositionType 1 record.
- Populating any other field on a PositionType 1 record will return an error during file processing.
Understanding RecordID
RecordID is a system-generated identifier added to Staff Vacancy submissions in March 2026. It works much like a SID or SMID. NJSLEDS assigns a unique eight-digit RecordID to each vacancy record so the system can match and update the correct record over time.
When you submit a new vacancy record, leave the RecordID column blank. NJSLEDS assigns the RecordID automatically once your file processes. After processing, export the Submission Records report to see the RecordIDs assigned to your records, then save them in your local tracking system.
When you later need to correct or update an existing record, include its assigned RecordID in your file. NJSLEDS reads a populated RecordID as an update to that specific record, and a blank RecordID always creates a new one. Reusing the correct RecordID is what keeps an update from being recorded as a duplicate vacancy.
If you see a RecordID error
What you see: The Record ID uploaded for this record does not exist in NJSLEDS.
What it means: The RecordID in your file does not match a RecordID that NJSLEDS has issued. This usually happens when a RecordID is mistyped, or when a new record is uploaded with a RecordID already filled in.
How to fix it: If you are reporting a new vacancy, leave RecordID blank and let NJSLEDS assign one. If you are updating an existing record, export the Submission Records report to confirm the correct eight-digit RecordID, then re-upload your file with that value.
Field Guidance
Quick reference for each field in the Staff Vacancy submission file. For full details, see the Data Handbook.
| Field | Definition |
|---|---|
| RecordID | A system-generated, eight-digit identifier NJSLEDS assigns to each vacancy record. Leave blank for new records; reuse the assigned RecordID when updating an existing record. |
| SchoolID | The school code from the district’s County District School Information. |
| PositionType | The employment-related status of types of teaching positions within a district or school. See “Choosing the Right PositionType” above for the valid values. |
| JobCode | The NJDOE job code associated with the position type. |
| JobCodeSubcategory | The subcategory linked to the job code associated with the position type. |
| DistrictPositionID | Assigned by the district and used to track staff positions within a district over time. |
| PositionOpenDate | The year, month, and day on which a position opened. |
| PositionClosedDate | The year, month, and day on which a position closed. |
| NumberOfApplicants | Total count of applicants who have applied for current job vacancies or new teacher positions within the district or school. |
⚠️ Common Issues to Avoid
- Report teaching positions only, as defined by the valid job codes in the Job Codes and Job Code Subcategories document. Do not include positions that fall outside that list.
- Use PositionType 1 only when a school has no vacancies to report, and submit a single record with all other fields blank. Do not create a PositionType 1 record for every position.
- Leave RecordID blank for new records. Reuse the assigned RecordID only when updating a record you already submitted.
- Each row must represent a unique combination of SchoolID, PositionType, JobCode, JobCodeSubcategory, and DistrictPositionID
- Dates must be formatted as YYYYMMDD
- PositionClosedDate cannot be earlier than PositionOpenDate
- Do not leave NumberOfApplicants blank — enter 0 if no applicants have applied
