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.

1

Choose data

Open an existing Test Data Set, or upload a CSV when your role allows it.

2

Build

Drag fields into Rows, Columns, Values, and Filters. The pivot updates as you work.

3

Save report

Save the report as private, school shared, or system shared depending on your role.

4

Share or export

Open reports later, share them with the right audience, or export to CSV or Word.

Tip
In a hurry? The Dashboard turns your official results into charts with no report building required — start there if you just want a quick look at proficiency or performance levels.
i
System Reports behave differently. When a school opens a System Report, DataVot replaces the system dummy data with that school's matching data set.


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.

1

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.

2

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.

3

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.

4

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.

Tip
Use Start Report from a Test Data Set to build a new pivot report from that data.

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 the same test across years into one report — your original data sets stay separate.
Y

Combine years

Bring 2024, 2025, and 2026 of the same test together to compare progress across years in one report.

S

Sources stay separate

Your original data sets are untouched and remain separate. The combined source just reads them together when opened.

C

Line up columns

When a column is named differently across years (for example Level vs Perf Level), line them up into one column.

F

Filter rows

Keep only the rows that match conditions you set — for example, Grade equals 4 and Subject equals Math.

i
How to do it. Open a Test Data Set that has more than one year and click Compare across years (it also appears as a banner in the workspace), or use + Add data set while a data set is open to pick which sets to combine. The combined report opens ready to build on; for a single year, just open the data set directly.

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 categoryWho sees itHow it behaves
System ReportsAll schoolsCreated by System Admin from system dummy data. Schools open them with their own matching data.
School ReportsSchool district membersShared reports created by a school admin or teacher for that district.
My ReportsOnly the creatorPrivate reports for the signed-in user.
1

Open from Reports

Use the Reports page to open System Reports, School Reports, and My Reports.

2

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.

3

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.

Pick a test from the dropdowns and the chart redraws — no report building.

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.

i
Separate or Combined. Each checkbox menu has a Separate / Combinedswitch at the bottom. Separate gives each value its own bar (each school, each subject, each year). Combined rolls them together — combine schools to see the whole district as one bar, or combine ELA and Math into a single result. ELA and Math start out separate, because they are different tests.

Two ways to read the scores

P

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).

L

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.
i
Student privacy. The Dashboard only ever shows counts and percentages. Individual student rows never leave the server — the totals are calculated before the chart is sent to your browser.

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:

Drag fields into Rows, Columns, and Values — the table builds itself.
1

Start from a source

Open a Test Data Set or an existing report. Data sets open with the editor ready.

2

Drag or add fields

Drag fields from the field list into a zone, or use the Add button inside a zone.

3

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.

Drag fields into Rows, Columns, and Values — the table builds itself.

The four zones

ZoneWhat it doesTypical field
RowsDown the left. Each value becomes a row. Add a second field to nest inside the first — school, then grade within it.SchoolName, GradeLevel
ColumnsAcross the top. Each value becomes a column, which is what makes it a cross-tab rather than a list.PerformanceLevel, Subject
ValuesThe numbers in the body. Choose how each one is calculated — see Aggregations.Count of students, average ScaleScore
FiltersNarrows 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”.

i
Swapping is cheap. Drag a field from Rows to Columns and the table rebuilds instantly — nothing is recalculated from the file and nothing is lost. If a layout is not telling you what you hoped, try it the other way round before starting over.

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

AggregationWhat it gives you
CountHow 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 UniqueHow many distinct values. Counts each student once even if the file has a row per subject.
SumAdds the numbers together.
AverageThe mean — a district's average scale score, for instance.
MedianThe middle value. Worth reaching for when a handful of very high or very low scores would drag an average somewhere unrepresentative.
Min / MaxThe lowest and highest value in the cell.
VarianceHow spread out the values are. Two schools with the same average can look very different here.
First / LastThe first or last value encountered. Useful for carrying a label through rather than calculating anything.
i
Sum, Average, Median, Min, Max and Variance need a numeric field. If one is unavailable, the column is being read as text — the field type toggle in Computed Fields fixes that.

Showing values as percentages

Display modeReads as
ValueThe raw number.
% rowEach row's distribution across its columns — “of this school's students, what share reached each level?” Usually the one you want for performance levels.
% columnEach column's distribution down its rows — “of everyone who reached this level, what share came from each school?”
% grand totalEvery 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.

A filter narrows the report you already built — the source data set is untouched, and clearing the filter brings every row 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.

i
Totals reflect filters, not search. A filtered-out row is gone from the calculation, so totals and percentages recalculate. A row hidden by search is still counted — which is what you want, since search is only changing your view.

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.

i
If a column will not aggregate, check its type first. A numeric column that arrived with stray spaces or a footnote marker is read as text, and text can be counted but not summed or averaged. The type toggle fixes it without touching the file.

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

G

Grouped

Series sit side by side. Best for comparing sizes directly — how many Met at each school.

S

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.
i
Chart settings save with the report. Chart type, titles, axis labels, series colours, value labels, legend placement and bar style all travel with it, so reopening a saved report gives you the chart you set up rather than a default bar chart. A report you never opened the options on carries none of them and simply opens as a bar chart. For a picture you want to hand to someone else rather than reopen yourself, the Dashboard is still the shorter route — its selections live in the address bar, so a chart there is a link you can bookmark or send.

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:

RuleExample
Greater than / greater or equalHighlight every proficiency rate at or above 60%.
Less than / less or equalFlag any group below the district average.
Equal toPick out a single grade or level.
ContainsMatch 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.
i
Formatting is part of the report. Save the report and your decimals, colours and totals come back with it — unlike chart settings, which do not.

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.

Click any number to see the records behind it — searchable, sortable, and exportable. You only ever see students you have access to.

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.
i
Access applies here too. A teacher restricted to certain schools sees only those students' records, exactly as they do everywhere else. Drill-down is not a way around who can see what — the restriction is on the rows themselves, not on the screen.

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.

Use the CSV or Word button — the file is named after your report.
ButtonWhat you getGood for
CSVThe 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.
WordThe 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?”

i
Exports respect your access. A teacher restricted to certain schools exports only those schools' figures and only those students' records. There is no export that reaches further than the screen does.

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.

i
Administrators only, on purpose. School Admins and System Admins can open it; teachers cannot. A teacher restricted to some schools would produce a district table quietly missing the rest, and a table that is wrong in a way nobody can see is worse than no table.

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

  1. Students tested — both years and the difference.
  2. Percentages by performance level, by grade — the district across both years, with the change.
  3. Change compared with the state — your percentage-point movement beside New Jersey's.
  4. District compared with the state — level detail, split into lower, middle and upper bands.
  5. Schools, one grade — every school in the district side by side.
  6. One school compared with the district — the same level detail for the school you picked.
  7. 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.

i
Why some cells say 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

2

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.

NJ

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

RoleHow they get itWhat 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.
TeacherInvited 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

1

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.

2

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.

3

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.

!
One school per email. An email address can belong to only one school on DataVot — as its admin or as a teacher. Inviting an address that already belongs to another district is refused with a clear message. A teacher who works in two districts needs a separate email address for each; a teacher who changed districts should ask us to release their old membership.

School access for teachers

1

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.

2

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.

ToolPurpose
DistrictsA dedicated page for creating, editing, and managing school district accounts, admins, contracts, and user-account limits.
Test BlueprintsPart of Test Settings. Define official CSV blueprints by test name, year, season, and uploaded template CSV.
Test SettingsA dedicated page for test blueprints and settings for tests, years, seasons, and future setup values.
System Data SetsUpload reusable dummy/source data that does not belong to any school.
System ReportsBuild reports from system data and share them with schools read-only; each school sees the design with their own matching data.
Database ViewerSearch 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.

!
Consent is required. A support reason, consent note, and confirmation checkbox are required before a session can start. The session is logged and an email notice is sent.
1

Find user

Search by name, email, district, or role and choose the exact user.

2

Document consent

Enter why support is needed and how permission was given, such as by phone or email.

3

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.
i
Why a post can be rejected. Posts and comments are checked for profanity when you submit them, and a rejected post tells you which word tripped it. The check matches whole words only — “assessment” will never be flagged for the word inside it.

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.

RoleCan do
MemberPost, comment, like, report, edit their own profile.
ModeratorEverything above, plus hide or delete content, work the reported-content queue, and ban a member.
AdminEverything 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.

i
Articles are written by DataVot, not by members. You can like and comment on an article, but the library itself is published by the DataVot team. The Forum is the place to write.

Security and Data Access

DataVot separates system administration from school data access and records sensitive support actions.

CapabilitySystem AdminSchool AdminTeacher
Create districtsYes--
Define test blueprintsYes--
Upload system data setsYes--
Upload school data sets-Yes-
Combine school data sets across years-Yes-
Combine system data sets across yearsYes--
Create personal reportsYesYesYes
Create school reports-YesYes
Use Act As supportYes--
Note
“School Admin” here means both the primary admin and any co-admins — they have identical rights. Your data is stored securely in the cloud. It is never sold, and it is shared only with the infrastructure providers named on our Data Protection page.

Tips and Shortcuts

Small habits that make DataVot easier to use.

Click headerSort by that column. Click again to reverse.
Double-click resizeReset a resized column.
Click valueDrill down to see the source rows behind a number.
Range A1:ZUse an open-ended row range that extends to all loaded rows.
WordExport the current pivot table as a Word-compatible document.
Compare yearsCombine the same test across years into one report without merging the raw data sets permanently.

Good report design

1

Put comparison fields in Columns

For performance levels, subjects, seasons, or years, Columns usually creates the clearest table.

2

Use percentages for distribution

Use % row or % column when the question is about share, not count.

3

Save reusable reports

Once a report answers a recurring question, save it so it can be reopened when new data arrives.