# Imports

> From FilmScorecard Help: https://www.filmscorecard.com/help/imports

Every FilmFreeway export this season has taken, and the one running right now —
and, on a festival [connected to FilmFreeway](https://www.filmscorecard.com/help/connecting-filmfreeway.md),
every sync that brought new films in. This is where you watch an import, stop
it, retry it, and — for thirty days — undo it.

Starting an import is a separate four-step job; see
[Importing submissions](https://www.filmscorecard.com/help/importing-submissions.md). This page is about what
happens after you press the button.

## Finding the screen

**Imports** is the third row in the season block of the left navigation, under
your festival's name, below Dashboard and Submissions. Like Submissions it
carries no count — a tally of past imports is not something anyone is waiting
on.

Its address is:

```
/org/<organization>/<festival>/<season>/imports
```

The **Import submissions** button on the [Submissions](https://www.filmscorecard.com/help/submissions.md)
toolbar, and the one in its empty state, both land here. So does the
[Season overview](https://www.filmscorecard.com/help/season-overview.md), whether or not judging is open yet:
its **Import batches** card shows this same history, and both its **All
imports** link and its rollback strip's **Continue in Imports** button end up
on this screen.

## Who can work here

Everyone in your organization who can open the season, with the same buttons.
There is no read-only version: owners and staff members have identical
capability, including rollback.

Anyone else who opens the address — including hosts of other festivals — sees an
ordinary "page not found". A logged-out visitor is sent to the log-in screen
first.

## One import at a time

**A season runs one import at a time.** While a batch is queued or running, the
**Import submissions** button is not on the screen at all — the job card has
taken its place — and it returns as soon as the batch finishes, however it
finishes.

If a second tab tries to start one anyway it is refused with "An import is
already running for this season. Wait for it to finish, then try again."

**A FilmFreeway sync gives way to your import.** On a festival connected to
FilmFreeway, a sync that comes round while a CSV import is queued or running in
the season changes nothing — the **FilmFreeway** tab of Settings reads "The
9:00 AM sync waited for an import to finish." — and the next sync does the
work. A sync never holds up an
import: its own batches are never queued or running here, so **Import
submissions** stays on the screen while one runs.

Half-finished imports are not the same thing. You can leave as many unconfirmed
uploads behind as you like, none of them blocks anything, and they are deleted
automatically after seven days.

## The job card

One card, three states — Queued, Running, Failed. Only the pill, the bar, the
count, the time and the buttons change, and **there is no spinner anywhere**:
the work is not being done by this page's request, so the page never pretends to
be holding it. The card refreshes itself every few seconds while a batch is
queued or running, and you do not need to reload.

### Queued

> Waiting for the next run, usually under a minute. Nothing has been written
> yet, so cancelling now leaves the season untouched.

The card shows the file name, "0 of 312 imported", the time it was queued, and
one button: **Cancel import**.

The number on the right while a batch is queued is the **rows read from the
file**. Once it starts running, it becomes **the number that will actually be
imported** — so the total can drop when the bar starts moving. That is the
skipped rows leaving the count, not rows going missing.

### Running

> Submissions appear in the list as they are written. This page updates on its
> own, and the import keeps going if you close it.

A progress bar, "33 of 148 imported" ticking upward, the time it started, and
two things to do: **Stop after the current row**, and **View the 33 imported so
far**, which opens the season's [Submissions](https://www.filmscorecard.com/help/submissions.md) list. That list
is the whole season, not just this batch — there is no per-batch filter yet.

**Closing the page does not stop the import.** Come back and the card is where
the work got to.

Once you have asked it to stop, the copy changes to:

> Stopping after the current row. The whole batch will be rolled back, so the
> season ends up unchanged.

### Failed

The pill turns amber, the line reads "Stopped at row 87 of 148", and an amber
block gives the row and the cause, followed by:

> The whole batch was rolled back, so all 148 rows are still unimported and the
> season is unchanged. Retrying cannot double import.

Two things to do: **Retry this import** and **Download the error report**.

## Cancel, Stop and Retry

### Cancel — only while it is queued

**Cancel import** is offered in the queued state and nowhere else, because
queued is the only state in which nothing has been written. It removes the job,
the season is untouched, and **no history row is created** for an import that
never started.

If the import began in the moment between your click and the request arriving,
Cancel refuses with "That import has already started. Use Stop after the current
row instead." — and the card will already be showing that button.

Cancelling returns the import to an unconfirmed state with your column mapping,
your category mapping and your cell edits intact. **The screen does not offer a
way back into it**: Imports lists finished batches only, and **Import
submissions** starts a fresh upload at step 1. Your browser's Back button leads
to the preview you were on; otherwise, upload the file again.

### Stop — while it is running

**Stop after the current row** does exactly what it says: the row being written
finishes, and then **the entire batch is rolled back**. It is not a pause and
not a partial import — a batch is either fully in or fully out.

The batch lands in history as **Canceled**, reading "Stopped. The whole batch was
rolled back.", with Retry offered.

If the import finished in the meantime, Stop refuses with "That import had
already finished. Refresh to see what it did."

### Retry

**Retry this import** runs the same file again, and it is offered on any batch
that failed or was stopped. Both of those are empty by definition — their
rollback has already run — so **retrying cannot import anything twice.**

Everything is decided again from scratch when the retry starts, against the
season as it is now. That matters if you fixed the cause in the meantime: a
category you have since renamed, or submissions another import added, are taken
into account. **Your column mapping is not re-derived** — the retry reads the
same map you settled on step 2, so it imports what you saw. **So is your
Ready for judging / On hold choice**: a retried batch puts its new submissions
where the original confirm said.

Retry is on the job card while a failure is on screen, and on the history row
afterwards.

Two refusals you may see: "An import is already running for this season. Wait
for it to finish, then try again.", and "This import could not be queued again.
Nothing was written; try Retry once more."

## Why an import fails, and what it costs you

**Nothing in the season.** Every failure path rolls the whole batch back before
it reports itself, so a failed import leaves the season exactly as it was.

**The one thing a failure can leave behind is in your library, not the
season**: a category you mapped to FilmScorecard's default list on step 3 is
imported into your library before any submission is written, and it stays there
— with its scorecards — however the batch ends. A retry finds it already there
and does not import it again. See
[Importing from the default list](https://www.filmscorecard.com/help/importing-from-the-default-list.md#from-a-filmfreeway-import).

Causes you may see on the card, in history, and in the error report:

| Cause | What happened |
| --- | --- |
| A row number and a database message | One row could not be written. The report names the row and prints its values. |
| "These categories are no longer in this season: … Start the import again to map them." | A category was renamed or deleted between mapping and running. Retrying will fail the same way; start a new import and map the names again. |
| "A category picked from the FilmScorecard default list is no longer in it. Start the import again to map it." | A category you mapped to the default list has since been taken off it. Nothing was written. Retrying will fail the same way; start a new import and map the name again. |
| "The import stopped without finishing — the server it was running on ended the job. The whole batch was rolled back, so nothing from this file is in the season." | The run was cut short. Retry is safe. |
| "The previous attempt could not be cleared, so this import did not start. Nothing was written." | Leftovers from an earlier attempt could not be removed. Try Retry again. |
| "Some of this batch could not be removed automatically — the season may still hold part of it. Use Retry, which clears the batch before it starts." | **The only message that says the season may not be clean.** Retry clears the batch before it runs, which is what puts it right. |

### The error report

**Download the error report** on a failed batch gives you a plain text file named
after the batch, such as `IMP-2026-08-08-1-errors.txt`. It holds the batch code,
the file name, the season, how many rows were read, the failing row number, the
cause, and **every column of the failing row exactly as the file has it** — so
you can open it beside the CSV and fix the row.

The report stays available for as long as the history row does, which is
forever.

## History

Every batch that reached an end is listed, newest first, with the date and time
in the left column, the file in the middle, and a status pill on the right. The
list shows the 200 most recent batches.

Each row carries:

- **The file name**, as you uploaded it.
- **What it did** — one of "148 imported", "148 imported, 6 skipped as
  duplicates", "Failed. The whole batch was rolled back.", "Stopped. The whole
  batch was rolled back." or "Rolled back. Nothing from this file is in the
  season."
- **Who ran it, and how many rows were read from the file.**
- **A pill**: Complete in green, Failed in amber, Canceled in grey, Rolled back
  in grey. Rolled back replaces whatever the batch was before.

**A FilmFreeway sync that brings new films adds a row of its own.** On a
festival connected to FilmFreeway, it is named **FilmFreeway sync** where a
file name would be, names nobody as who ran it, and counts the new films that
sync brought in. A sync that brings nothing new — only updates to films already
here — adds no row. A sync's row reads Complete — or Rolled back, once **Undo
sync** has taken the sync's films out — so it never offers Retry or an error
report; trouble reaching FilmFreeway shows on the **FilmFreeway** tab of
Settings instead. **View** opens the films it brought in, as on any other row.
**No sync's row offers Undo** — see
[FilmFreeway syncs are undone from Settings](#filmfreeway-syncs-are-undone-from-settings).

Before your first import the panel reads "No imports yet" — "Every import you
run appears here, with the option to roll it back for 30 days."

**History rows are permanent.** A batch you rolled back keeps its row and says
so; a batch too old to roll back keeps its row and simply loses the button. The
row never disappears, because this list is the record of what was done to the
season.

## Rolling a batch back

**Undo** appears on a completed batch imported from a file, beside **View**
(which opens the submissions it imported), **for 30 days from the moment it
finished**, and
then goes away. The deadline is enforced when you
press the button, not just when it is drawn, so a tab left open overnight cannot
talk you past it: "The 30 day rollback window for this batch has passed. The
batch stays in history."

The **Roll back batch** button on the [Season overview](https://www.filmscorecard.com/help/season-overview.md)'s
Import batches card is a signpost to this one: it names the batch and what
removing it would cost, and hands you over here — nothing is ever removed from
that dashboard. This screen is the only place a rollback happens.

The dialog names the exact cost:

> Removes all 148 submissions imported in this batch. Scorecards and assignments
> on them will be removed.

Underneath it sits the batch code and file name — `IMP-2026-08-08-1,
pcff-2026.csv` — and a single checkbox: "I understand these 148 submissions will
be removed." There is no phrase to type; the count in the sentence is the thing
worth reading. Then **Keep the batch** or **Roll back 148 submissions**.

**The dialog's second sentence promises more than a rollback will now do.** A
batch any creative scorecard has been started on is refused outright, before
anything is removed — see
[A batch judges have scored is refused](#a-batch-judges-have-scored-is-refused).
The scorecards a rollback can still remove are technical and press-kit ones.

### What a rollback removes, exactly

**Only what this batch wrote, and all of it:**

- **The submissions it created**, with their versions, their category
  attachments and any flags people put on them — and whatever **On hold**
  marks they carried.
- **Category entries it added to submissions that already existed** — those come
  off, and **the submission itself stays**. A batch that only added a second
  category to an entry you already had removes the second category and nothing
  else.
- **Categories the import added to this season**, unless something outside the
  batch has come to use them since. A category that has picked up other
  submissions is kept. **The category comes off the season only**: your
  library keeps it — whether step 3 created it, attached it from your library,
  or brought it in from the default list with its scorecards and award links.

Nothing that arrived by another route is touched, and no other batch is
affected.

**Anything you typed onto a submission this batch created goes with it** — the
statement, the tagline, a poster you uploaded, corrected credits. They are part
of the submission's own record, so removing the submission removes them, and
there is nothing to tidy up first.

**An email already sent stays sent.** On a season set to
[email each filmmaker as their film arrives](https://www.filmscorecard.com/help/season-overview.md#how-filmmakers-hear-from-you),
the batch's filmmakers have most likely been sent the link to their submission
page already — it goes within minutes of the import finishing. A rollback
cannot take that email back; the link in it stops working.

### A batch holding an unlocked scorecard is refused

**A submission whose filmmaker has unlocked their scorecard cannot be removed**
— a receipt is never quietly destroyed — so a batch holding one is refused
whole, and **nothing is removed at all**. The question is asked before the
rollback starts, and the answer names what is in the way:

> 1 submission in this batch has had its scorecard unlocked by the filmmaker,
> and a scorecard somebody has opened is never deleted. Nothing has been rolled
> back, and rolling back will keep refusing while those receipts exist. Withdraw
> those submissions instead, or ask support to remove the receipts first.

- **The count is submissions, not unlocks.** A film unlocked in two categories
  holds two receipts and is still one submission in the way.
- **Every kind of unlock counts**, and so does one that was refunded
  afterwards: a purchase, a comp somebody on your staff granted, a free unlock
  on a $0 season.
- **The season is exactly as it was.** Nothing was deleted, no categories were
  detached, and the history row still reads Complete with its Roll back button.
- **Pressing it again changes nothing.** The refusal is permanent while those
  receipts exist. **Withdraw** the submissions you wanted gone instead — see
  [Withdrawing a submission](https://www.filmscorecard.com/help/submissions.md#withdrawing-a-submission) — or
  ask whoever administers FilmScorecard for you.

The rule to work by: **once any of a season's scorecards have gone out — with
the season's release, or one submission at a time — treat its imports as
final.** See [Releasing scorecards](https://www.filmscorecard.com/help/releasing-scorecards.md) and
[Releasing one submission's scorecard](https://www.filmscorecard.com/help/releasing-one-scorecard.md).

Rolling back a batch whose submissions have codes but **no** unlocked
scorecards is not blocked: the access codes go with the submissions, and those
links stop working.

### A batch judges have scored is refused

**A judge's scorecard is never deleted by a rollback**, so a batch that any
creative scorecard has been started on is refused whole, and **nothing is
removed at all**. This is asked after the unlocked-scorecard question and
before anything is touched:

> 1 submission in this batch has been scored by a judge, and a judge's
> scorecard is never deleted. Nothing has been rolled back. Withdraw those
> submissions instead.

— or "3 submissions in this batch have been scored by judges, …" for more than
one.

- **"Scored" means any creative scorecard on the film**, from the moment a
  judge presses **Start scoring** — filed or not, approved or not. A creative
  scorecard a colleague filled in from the Submissions list counts too, even
  though the sentence says "a judge". So does one filed under a category the
  film has since left.
- **It covers the category entries this batch added to older submissions as
  well**: a judge scoring a submission in a category this batch attached is
  enough to refuse it.
- **Technical and press-kit scorecards do not refuse a rollback.** They go with
  the submissions, as the dialog says.
- **The season is exactly as it was**, and the history row still reads
  Complete with its Roll back button. Pressing it again refuses the same way
  for as long as those scorecards exist.

So **once judging has started on a batch's films, treat that batch as final**:
withdraw the submissions you wanted gone — see
[Withdrawing a submission](https://www.filmscorecard.com/help/submissions.md#withdrawing-a-submission) — or put
them [On hold](https://www.filmscorecard.com/help/submissions.md#holding-a-submission-out-of-judging) to stop any
more judges taking them.

### FilmFreeway syncs are undone from Settings

**No FilmFreeway sync row carries Undo — the first sync's included.** The films
the sync brought into the season come out together, every sync at once, with
**Undo sync** on the **FilmFreeway** tab of Settings. See
[Connecting FilmFreeway](https://www.filmscorecard.com/help/connecting-filmfreeway.md).

- **It is refused whole, before anything is removed**, while a sync is queued
  or running, more than 30 days after the season's first sync row, once a
  judge has started scoring any of those films, or once a filmmaker has
  unlocked the scorecard for any of them. The reason shows under the greyed
  **Undo sync** — for example "A judge has scored 2 of these submissions."
- **A film you had imported from a CSV before the sync found it stays**, and
  stops syncing.
- **Afterwards every sync row here reads Rolled back.** With the key still
  saved, nothing syncs again until somebody presses **Finish setting up** on
  the FilmFreeway tab and chooses a season.
- **A tab left open from before can still show Undo on a sync row.** Pressing
  it is refused with "Undo FilmFreeway syncs from Settings → FilmFreeway." —
  and nothing is removed.
- **The Season overview's Import batches card agrees**: no sync row there has
  Roll back batch.

To take one synced film out of judging without undoing the rest, withdraw it —
see [Withdrawing a submission](https://www.filmscorecard.com/help/submissions.md#withdrawing-a-submission).

### Do not roll back a batch whose submissions have been moved

**This is a known gap, and it is not caught for you.** A submission that has
been [moved to another season](https://www.filmscorecard.com/help/submissions.md#moving-a-submission-to-another-festival)
is no longer in this season, so the rollback does not remove it — but its
screener link, screener password, running time and page count were written by
this batch, and the rollback removes those wherever the submission now is. It
then fails on that submission, with "That did not work. Try again.", and
**retrying fails the same way every time**. By then the batch's other
submissions have left the season, the moved film sits in its new season with no
screener and no length, and the history row never reads Rolled back.

The rule to work by: **once any submission a batch created has been moved to
another season, treat that batch as final.** If you have already tried it, do
not keep pressing Retry — ask whoever administers FilmScorecard for you.

### After a rollback

The history row stays, its pill becomes **Rolled back**, and its line reads
"Rolled back. Nothing from this file is in the season."

**There is no undo.** The way back is to import the file again, which is a clean
import like any other — nothing is left behind to collide with it.

Six refusals: "Only a completed batch can be rolled back." (a failed or
stopped batch is already empty), the 30-day message above, the unlocked-
scorecard sentence and the scored sentence in full — the two refusals that tell
you exactly what is in the way — the FilmFreeway sentence above, and
"That did not work. Try again.", which is
usually a transport fault rather than anything about the batch's contents, and
safe to retry: a rollback removes what it finds, so running it again finishes
whatever an interrupted attempt left. The one exception is the moved-submission
case above, where retrying cannot help.

## Smaller things worth knowing

- **The batch code** — `IMP-2026-08-08-1` — is the date plus that day's number
  for this season. It appears in the rollback dialog and in the error report,
  and is what to quote if you need to ask about a particular import.
- **Where an import shows up elsewhere.** Imported submissions reach the
  [Submissions](https://www.filmscorecard.com/help/submissions.md) list as they are written, count towards the
  number in its title, and — while the season is still a draft — finish the
  **Import submissions** step of the
  [Finish setting up](https://www.filmscorecard.com/help/finishing-setup.md#the-three-required-steps) strip,
  which then reads "148 imported from FilmFreeway on Aug 3, 2026". The
  [Season overview](https://www.filmscorecard.com/help/season-overview.md) carries this same batch history in
  its Import batches card.
- **They also reach your judges** — unless you put them on hold. Once judging
  is open — the season opened with **Open judging** on its dashboard, and its
  opening date passed — an imported submission is offered to whichever judges
  are in scope for it, exactly as a submission you entered by hand would be —
  there is nothing to activate and no second step. Import mid-window and the
  new films join everybody's queue on their next visit. **An import into a
  season nobody has opened yet reaches no judge**, whatever its dates say,
  until somebody presses Open judging. **A batch confirmed with On hold**
  reaches no judge at all until you set its films Ready — see
  [Ready for judging or On hold](https://www.filmscorecard.com/help/importing-submissions.md#ready-for-judging-or-on-hold).
  See [How the judging queue works](https://www.filmscorecard.com/help/how-the-judging-queue-works.md) and
  [Opening judging](https://www.filmscorecard.com/help/opening-judging.md).
- **And their filmmakers, on a season set to email each one as it arrives.**
  Each submission the batch brings in that is in a category is sent the link
  to its submission page within minutes of the import finishing — or, on a
  draft season whose Judging opens date has passed, once you open judging. On
  a season set to send them yourself, or one nobody has decided for, nothing
  goes until you send it. See
  [How filmmakers hear from you](https://www.filmscorecard.com/help/season-overview.md#how-filmmakers-hear-from-you).
- **A row FilmFreeway had already marked withdrawn arrives like any other.**
  Nothing reads FilmFreeway's Submission Status column, so such a row lands as
  an ordinary submission and is judged unless you withdraw it yourself on the
  [Submissions](https://www.filmscorecard.com/help/submissions.md) screen. Worth a pass down the list after a
  late-season import. Its **Judging Status** is read, but only to set the
  selection — see
  [Judging status sets the selection](https://www.filmscorecard.com/help/importing-submissions.md#judging-status-sets-the-selection).
  **The FilmFreeway sync does read a film's status there.** A film the sync
  brings in, or keeps up to date, whose filmmaker withdrew it on FilmFreeway is
  withdrawn here by that sync — unless a judge has started scoring it or its
  scorecard has been unlocked, in which case it only carries a notice on its
  record. The sync withdraws a film once, and never again. Like any
  withdrawal, it cannot be reversed on your screens. A film disqualified on FilmFreeway is never changed here; it
  carries a notice. See
  [FilmFreeway notices](https://www.filmscorecard.com/help/opening-a-submission.md#filmfreeway-notices).
- **Withdrawn submissions still count as imported.** A batch that imported 148
  rows keeps saying 148 even after you withdraw some of them on the Submissions
  screen — and rolling it back removes them all, withdrawn ones included.
- **Moved submissions still count as imported, too.** A film moved to another
  season stays in the batch's count and keeps the batch as its origin — which
  is exactly why the batch can no longer be rolled back; see above.
- **What an import writes into the record.** A FilmFreeway export carries no
  tagline and no poster, so imported submissions arrive without either. The
  column you mapped to **Submitter statement** becomes the submission's one
  statement, exactly as the file has it — headed *Director's statement* on a
  film and *Writer's statement* on a screenplay, and credited to nobody. The
  submitter's personal details, technical specs, background and the entry's own
  record land in staff-only cards on the submission's Information tab. See
  [What a FilmFreeway export brings in](https://www.filmscorecard.com/help/importing-submissions.md#what-a-filmfreeway-export-brings-in).
