DataVot Help
DataVot helps New Jersey schools turn official NJSLA test data into reusable reports, shared templates, and cross-year views.
This guide reflects the current app structure: the Dashboard, Test Data Sets, Reports, Users, Resources, and the System Admin tools (districts, test setup, system data, Database Viewer), plus consent-based Act As support.
Quick Start
The normal workflow is: load data, build a pivot table, save it as a report, and reopen it later. A pivot table is simply a way to summarize your data — for example, counting how many students reached each performance level, broken down by school.
Choose data
Open an existing Test Data Set, or upload a CSV when your role allows it.
Build
Drag fields into Rows, Columns, Values, and Filters. The pivot updates as you work.
Save report
Save the report as private, school shared, or system shared depending on your role.
Share or export
Open reports later, share them with the right audience, or export to CSV or Word.
Test Data Sets
A Test Data Set is the official data for one school district and one test administration. It is identified by test name, year, and season.
Blueprint check
Before a school CSV is accepted, DataVot checks it against the system-defined Test Blueprint. If columns are missing or wrong, the upload is blocked and the user sees what needs to be fixed.
No duplicate official data
A school can have only one official data set for the same test name, year, and season. If one already exists, the school admin must update or delete the existing data set.
Update Data Set
Updating replaces the CSV behind that official data set. Reports based on it (including cross-year comparisons) continue to use the same logical source, and ranges can be adjusted automatically when row counts change.
Delete Data Set
School admins can delete a whole data set after confirmation. DataVot warns that reports using that source (including cross-year comparisons) may stop working until replacement data is uploaded.
Compare across years
When you have the same test for more than one year or season, you can combine those data sets into one source and build a single report across them — without copying any data. You don't set this up as a separate thing: DataVot offers it to you in context whenever your data makes it useful.
Combine years
Bring 2024, 2025, and 2026 of the same test together to compare progress across years in one report.
Sources stay separate
Your original data sets are untouched and remain separate. The combined source just reads them together when opened.
Line up columns
When a column is named differently across years (for example Level vs Perf Level), line them up into one column.
Filter rows
Keep only the rows that match conditions you set — for example, Grade equals 4 and Subject equals Math.
Reports
A report is a saved pivot table design: rows, columns, values, filters, formatting, display modes, chart settings, and the source it was built from.
| Report category | Who sees it | How it behaves |
|---|---|---|
| System Reports | All schools | Created by System Admin from system dummy data. Schools open them with their own matching data. |
| School Reports | School district members | Shared reports created by a school admin or teacher for that district. |
| My Reports | Only the creator | Private reports for the signed-in user. |
Open from Reports
Use the Reports page to open System Reports, School Reports, and My Reports.
System templates use local school data
When a school opens a system template, DataVot looks for the matching school data set by test, year, and season, then recalculates the report with school data.
Range updates
If a school updates a data set and the row count changes, DataVot can update the saved range and show a clear message that the report has been recalculated.
Dashboard
The Dashboard turns your official test results into bar charts — no report building required. Pick a test from the dropdowns at the top and the chart redraws. It's available to school admins, teachers, and System Admins; teachers see only the schools they have access to.
Choosing what to show
The selectors at the top feed the chart. Test and Season are single choices; Years, Subject, Test code, and Schools are checkbox menus where you can pick several at once (leaving a menu on “All” means no filter). System Admins also pick a District first.
Two ways to read the scores
Proficiency Rates
Shows the share of students who are proficient. Which performance levels count as proficient is set per test in System Admin → Test Blueprints (for NJSLA, Level 4 and Level 5 by default).
Performance Levels
Shows the full breakdown of every level in each bar, stacked from lowest (red) to highest (green).
% or Count
Switch between percentages and the number of students. This applies to both views above.
Chart options
The icon button in the chart's top-right corner opens chart settings, like a spreadsheet:
- Orientation — vertical or horizontal bars.
- Cluster by — place bars of the same subject, test code, or year next to each other. This only arranges the bars; it does not merge them (that's what Combined does).
- Sort — order the bars A–Z or by highest / lowest proficiency.
- Color by (in the Proficiency Rates view) — color the bars by subject, year, or school. Each value keeps the same color everywhere — for example ELA is always blue and Math always amber — so the chart is easy to read at a glance. A small color key appears below the chart.
- Data labels, Legend, and Gridlines toggles.
Building Reports
The editor panel contains the pivot zones and the field list. Drag fields into zones to build the table — here's the idea in motion:
Start from a source
Open a Test Data Set or an existing report. Data sets open with the editor ready.
Drag or add fields
Drag fields from the field list into a zone, or use the Add button inside a zone.
Hide or show the editor
Close the editor panel for more table space. Use the green edit button to bring it back.
Pivot Zones
Every report is built from four zones. Which zone a field goes in decides what question the table answers — the same three fields arranged differently give you three different reports.
The four zones
| Zone | What it does | Typical field |
|---|---|---|
| Rows | Down the left. Each value becomes a row. Add a second field to nest inside the first — school, then grade within it. | SchoolName, GradeLevel |
| Columns | Across the top. Each value becomes a column, which is what makes it a cross-tab rather than a list. | PerformanceLevel, Subject |
| Values | The numbers in the body. Choose how each one is calculated — see Aggregations. | Count of students, average ScaleScore |
| Filters | Narrows which rows are included at all, without appearing in the table. | TestAdministration, SchoolName |
Choosing where a field goes
A useful rule: put the thing you want to compare across in Columns, and the thing you want to read down a list in Rows. Performance level in Columns and school in Rows gives you one row per school and one column per level, which is the shape most people are picturing when they ask for “the results by school”.
Aggregations and Display Modes
Every field in Values is calculated somehow. The default is Count, which answers “how many students?” — change it on the field itself when you want a different question answered.
How a value can be calculated
| Aggregation | What it gives you |
|---|---|
| Count | How many rows fall in the cell. Works on any field, numeric or not. This is the one you want for “how many students scored at each level”. |
| Count Unique | How many distinct values. Counts each student once even if the file has a row per subject. |
| Sum | Adds the numbers together. |
| Average | The mean — a district's average scale score, for instance. |
| Median | The middle value. Worth reaching for when a handful of very high or very low scores would drag an average somewhere unrepresentative. |
| Min / Max | The lowest and highest value in the cell. |
| Variance | How spread out the values are. Two schools with the same average can look very different here. |
| First / Last | The first or last value encountered. Useful for carrying a label through rather than calculating anything. |
Showing values as percentages
| Display mode | Reads as |
|---|---|
| Value | The raw number. |
| % row | Each row's distribution across its columns — “of this school's students, what share reached each level?” Usually the one you want for performance levels. |
| % column | Each column's distribution down its rows — “of everyone who reached this level, what share came from each school?” |
| % grand total | Every cell as a share of the whole table. |
Grand totals follow the display mode, so a table shown as percentages totals to 100% rather than to a count.
Filtering and Searching
Two different tools that are easy to confuse. A filter changes which source rows go into the report at all. Search changes only what you can see on screen right now. Neither touches the data set underneath, and clearing either brings everything back.
Filters
- Drop a field into the Filters zone and choose which values to include. The field does not appear in the table — it just narrows what feeds it.
- Filter on a field you are already showing. Putting SchoolName in both Rows and Filters is normal: show a row per school, but only the three you care about.
- Filters are saved with the report. Reopen it next year and the same filter is applied to the new file.
Search
Search narrows the visible rows of the table you are looking at, without changing the report. It is the faster tool when you are hunting for one row and do not want to alter anything — and because it changes nothing, you do not need to undo it.
Computed Fields
Sometimes the field you want to group by is not in the file. Computed fields make one inside DataVot — the uploaded data set is never modified, and the new field lives with the report you built it in.
Binned fields
Group a numeric column into ranges. A scale score is a different number for almost every student, so grouping by it directly gives you a row per student and tells you nothing; binned into bands, it becomes a distribution you can actually read.
Derived fields
Build a new number from columns you already have, plus constants — a difference between two scores, a ratio, a scaled figure. The result behaves like any other numeric field: you can put it in Values, aggregate it, format it and chart it.
Field type toggle
DataVot works out whether each column is a number or a category when the file is read. It is usually right, but a column of grade levels stored as 03, 04 can be read either way. Switch the type when the guess is unhelpful — a field read as text cannot be averaged, and one read as a number sorts numerically rather than by label.
Chart View
Switch a report from Table to Chart and the same result is drawn as a chart. Nothing is rebuilt — it is the table you already made, shown a different way, and you can switch back and forth freely.
What a chart needs
At least one field in Rows and one in Values. Each row group becomes a bar; each value or column becomes a series within it. If the chart looks empty, that is almost always what is missing.
Four chart types
Chart options → Chart type switches between them. A bar chart is the default and is the right answer most of the time.
- Bar — comparing sizes across groups. The only type that stacks, so the Bar style setting below appears for this one alone.
- Line — a value moving across an ordered row field, most often a year.
- Area — the same shape as a line with the space beneath it filled, which reads as a quantity rather than a rate.
- Scatter — one point per row, using your first two value fields as the horizontal and vertical axes. With only one value field it plots that field against itself and says so on screen, so add the second field you want to compare.
Three ways to stack the bars
Grouped
Series sit side by side. Best for comparing sizes directly — how many Met at each school.
Stacked
Series sit on top of each other, so each bar is a total. Best when the whole matters as much as the parts.
100% stacked
Every bar fills the height, showing shares rather than counts. Best for comparing distributions across schools of different sizes.
Making it presentable
- Chart title and axis labels — write your own rather than living with the field names.
- Series colours — set per series, so Met and Exceeded can read as related.
- Value labels — print the number on each bar, which usually beats making the reader estimate against a gridline.
- Legend placement — move it, or turn it off when the labels already say everything.
Formatting
Formatting changes how numbers look, never what they are. Nothing here edits your data set, and clearing a format leaves the underlying figure exactly as it was.
Number format
Set how many decimal places to show, add a prefix or suffix(a $, a unit, a word), or display a value as a percentage. Rounding is display-only — a rounded 66.5% still exports and totals as 66.5.
Conditional formatting
Colour the cells that meet a rule, so the eye lands on them first. Available comparisons:
| Rule | Example |
|---|---|
| Greater than / greater or equal | Highlight every proficiency rate at or above 60%. |
| Less than / less or equal | Flag any group below the district average. |
| Equal to | Pick out a single grade or level. |
| Contains | Match on text, such as every test code containing “ELA”. |
Totals and column widths
- Totals — turn the totals row and totals column on or off independently. With a percentage display mode, grand totals are shown as percentages too.
- Column width — drag the handle between headers. Double-click a handle to snap that column back to its original width.
See the Records Behind a Number
Any figure in a report is a count of real rows, and you can open them. Click a number and DataVot lists the records that make it up — so “why is this 34?” is a click rather than a question for whoever built the report.
What you can do with them
- Search and sort the records like any other table, to find the one row you are actually looking for.
- Export them to CSV or Word, or print them to PDF — the same buttons as a report.
- Close and carry on — opening records changes nothing about the report underneath.
Export
Export sends out what the table currently shows — your grouping, your filters, your totals. It is not a dump of the original file. Change the report and export again and you get the new shape.
| Button | What you get | Good for |
|---|---|---|
| CSV | The table as a comma-separated file, named after your report. | Excel or Google Sheets, or handing figures to someone who wants to keep working with them. |
| Word | The table as a Word-compatible document, laid out as a real table. | Dropping into a memo, a board packet or a grant application. |
Exporting the records behind a number
When you open the records behind a figure (see Behind a Number), that list has its own CSV and Word buttons, plus Print for a clean PDF. Those export the records themselves rather than the summary — useful when a colleague asks “which students are those?”
For the tables a board presentation needs, use the Board Report instead — it has its own Copy for PowerPoint button that pastes straight onto a slide.
Board Report
New Jersey asks districts to present assessment results to the board at a public meeting, and NJQSAC asks for student-group breakdowns on top of that. The Board Reportbuilds those tables from your own uploaded results, in the shape the state's own presentation template expects, so you paste rather than retype. Open it from the card at the top of Reports.
Setting it up
Choose the Test, Season, and two years — a Baseline year to compare against and the year you are presenting. Then pick the Grade for the school-by-school table, the School for the school-versus-district table, and the student Group for the last one. Change any picker and every table redraws.
The seven tables
- Students tested — both years and the difference.
- Percentages by performance level, by grade — the district across both years, with the change.
- Change compared with the state — your percentage-point movement beside New Jersey's.
- District compared with the state — level detail, split into lower, middle and upper bands.
- Schools, one grade — every school in the district side by side.
- One school compared with the district — the same level detail for the school you picked.
- Student groups — the disaggregated table NJQSAC asks for.
Getting them into your deck
Every table has two buttons. Copy for PowerPoint puts the table on your clipboard in a form PowerPoint and Word paste as a real table, keeping the rows and columns — paste it straight onto a slide. Download CSV saves the same figures as a file for Excel or Sheets. The downloaded numbers are the numbers on screen; they are formatted once and shared by both.
n<10. That is not missing data. When a student group at a school has fewer than ten students tested, the result is suppressed rather than published, because with a small enough group a percentage can identify an individual child. Ten is the reporting threshold NJQSAC uses. Leave those cells as they are — do not fill them in from another source.Two things to plan around
It needs two years
The template is built around year-over-year change. In your first year with DataVot the current-year tables are there and the comparison columns wait for the second file.
State figures arrive in the autumn
NJDOE publishes statewide results the autumn after a spring administration. Present before they are out and the state columns have no figures for that year — the page says so rather than drawing an empty column.
If a table is empty, the usual reason is that your district has no uploaded data set matching the test, season and years you picked. Check Test Data Sets first.
User Management
Every DataVot account belongs to a person, identified by their email address. This section is the complete guide to how school accounts work: the roles, how teachers join, what each person can do, and how account limits and purchasing work.
Roles in a school
| Role | How they get it | What they can do |
|---|---|---|
| School Admin (primary) | The account DataVot creates for your district — the account owner and billing contact. | Everything: invite and remove teachers, promote co-admins, upload and manage official data sets, manage reports and settings. The primary admin can never be demoted or removed. |
| School Admin (co-admin) | Any teacher promoted with Make admin on the Users page. | Exactly the same rights as the primary admin — equal partners in running the district's DataVot account. Any admin can promote or demote teachers; only the primary admin cannot be touched. |
| Teacher | Invited by email from the Users page. | Opens the district's data sets and reports (within their school access), builds personal reports, and — when sharing is enabled — shares reports with the school. All teachers are equals; no teacher outranks another. |
How teachers join
Send an invitation
On the Users page, enter the teacher's email and click Send invite. The invitation is for that exact address and works for 7 days; you can resend a fresh link at any time.
The teacher clicks the link
A teacher who is new to DataVot creates their account (first name, last name, password) and lands in the school immediately — no separate email verification needed.
Already have a personal account? It connects
Anyone can use DataVot with a free individual account before their school signs up. If you invite an email that already has an account, the teacher simply confirms their existing password and that same account joins the school — everything they built personally is preserved.
School access for teachers
Three explicit choices
Each teacher is set to All schools, Specific schools (only the buildings you tick), or No access. School names come from the school column of your uploaded data sets.
Applies to data and reports
Restrictions limit both the rows a teacher can see and which reports and combined sources they can open. Admins are never restricted — they always see the whole district.
Removing someone
Removing a teacher (or demoted co-admin) disconnects them from the school: they immediately lose the district's data sets, school reports, and dashboard, and their seat is freed. Their account itself is not deleted — they keep their login and any personal reports, reverting to a plain individual account. Any pending invitation for that address is cancelled at the same time, so an old link can't be used to rejoin.
Account limits & purchasing more
DataVot has one simple plan. Your district's subscription includes 30 user accounts in total — one of them the primary admin, leaving up to 29 for teachers. Admins and teachers each use one account; pending invitations hold an account until accepted or cancelled. The Users page always shows how many accounts are in use.
Need more? Additional accounts are added in blocks of 10, paid by purchase order — no credit card or online checkout. Current pricing is published at datavot.com/pricing. Send your PO to info@datavot.com (or use the Contact page) and we raise your district's account limit, usually the same day. The limit is enforced when invitations are sent and when they are accepted, so you can never be billed by surprise.
System Admin Pages
System Admin is the hub for system administrators. It links to focused pages so district accounts, test setup, system data, database review, and support work stay separate.
| Tool | Purpose |
|---|---|
| Districts | A dedicated page for creating, editing, and managing school district accounts, admins, contracts, and user-account limits. |
| Test Blueprints | Part of Test Settings. Define official CSV blueprints by test name, year, season, and uploaded template CSV. |
| Test Settings | A dedicated page for test blueprints and settings for tests, years, seasons, and future setup values. |
| System Data Sets | Upload reusable dummy/source data that does not belong to any school. |
| System Reports | Build reports from system data and share them with schools read-only; each school sees the design with their own matching data. |
| Database Viewer | Search and sort application records, including users, districts, settings, reports, data sets, combined data sets, and support access logs. |
Image size for articles
Settings → System Admin has a Max image size (px) value that applies to images uploaded to articles and community content. It is measured on the image’s longest edge, so it caps both tall and wide pictures with one number.
- Bigger images are scaled down automatically when you add them, keeping their proportions. You do not need to resize anything before uploading.
- Smaller images are left exactly as they are. Nothing is stretched or re-saved, so a small logo keeps its original sharpness.
- Animated GIFs are never resized, because resizing one would keep only its first frame and stop the animation.
- The limit applies wherever an image enters an article — the insert button, replacing an image, the cover image, and pasting or dragging a picture straight onto the page.
The default of 1920 px suits full-width article images on a large screen. Raise it if a detailed diagram needs to stay legible when a reader zooms in; lower it to keep pages loading quickly on school devices. There is a separate 5 MB limit on the file itself, which applies no matter what this is set to.
Act As Support Access
Act As lets a System Admin open a short support session as a school admin or teacher after explicit consent.
Find user
Search by name, email, district, or role and choose the exact user.
Document consent
Enter why support is needed and how permission was given, such as by phone or email.
Open support session
The session opens in a new window so the system admin session is not mixed with the support session.
Community
DataVot publishes Articles for New Jersey school staff, and runs a Forum where members can ask questions and compare notes. Both are linked from the footer. Anyone can read either without an account; posting, commenting, liking and reporting need you to be signed in.
Taking part
- Post to a category so others can find it, and reply with comments. Comments thread one level deep — a reply to a reply sits alongside it rather than nesting further.
- Mention someone with @ and they get an email. You can turn that off for yourself in the Profile popover (“Email me when I'm @mentioned”).
- Pick how you appear. Choose an emoji avatar and either your real name or a nickname. Your posts keep the name you had when you wrote them.
- Report anything that needs a look with the report action — it goes to a moderation queue, not to the author.
Moderation, and what happens to you
Community roles are separate from your DataVot role: being a School Admin does not make you a moderator. There are three.
| Role | Can do |
|---|---|
| Member | Post, comment, like, report, edit their own profile. |
| Moderator | Everything above, plus hide or delete content, work the reported-content queue, and ban a member. |
| Admin | Everything above, plus change who is a moderator. |
A ban stops you writing, never reading. A banned member keeps full access to every article and every thread — they simply cannot post, comment or like. Nothing you have already read is taken away from you.
Every moderation action is written to the activity log with who did it, so a decision can always be traced rather than argued about.
Security and Data Access
DataVot separates system administration from school data access and records sensitive support actions.
| Capability | System Admin | School Admin | Teacher |
|---|---|---|---|
| Create districts | Yes | - | - |
| Define test blueprints | Yes | - | - |
| Upload system data sets | Yes | - | - |
| Upload school data sets | - | Yes | - |
| Combine school data sets across years | - | Yes | - |
| Combine system data sets across years | Yes | - | - |
| Create personal reports | Yes | Yes | Yes |
| Create school reports | - | Yes | Yes |
| Use Act As support | Yes | - | - |
Tips and Shortcuts
Small habits that make DataVot easier to use.
Good report design
Put comparison fields in Columns
For performance levels, subjects, seasons, or years, Columns usually creates the clearest table.
Use percentages for distribution
Use % row or % column when the question is about share, not count.
Save reusable reports
Once a report answers a recurring question, save it so it can be reopened when new data arrives.