Greenroom
Settings

Onboarding Documents & Packets

Configuring start-work packets, from the base packet our tax partner collects to the templates, document library and company policies you add to it

Onboarding documents are under "Packets" in the main navigation

Onboarding documents are configured on the Packets page in the main navigation (page title: "Onboarding packets"), not in Settings. Links to Settings → Onboarding Documents open that page. Everything below describes the Packets page.

Packets are the sets of documents a payee signs during onboarding — tax forms, direct deposit authorization, company policies, and anything else you want on file before someone starts work. You need the Admin or Payroll role to configure them. With Approver, this page says Your Payroll and Admin teammates set up packets and points you to each payee's page for their packet status. For what a payee experiences when signing one, see Payee Onboarding.

What a start-work packet contains

Every payee gets one start-work packet, assigned from the Assign a start-work packet card on their page in Payees. It's built from three layers:

  1. A base packet for the payee's classification: the tax and banking forms our tax partner collects. You don't build or edit these.
  2. Greenroom documents from a template, if you pick one: Greenroom's standard documents and system forms, plus your own library PDFs. This is the part you configure on the Templates tab.
  3. Additional documents that Greenroom attaches by rule, such as your anti-harassment policy and confidentiality agreement for everyone, once you've published them. See Additional packet documents.
Base packetForWhat it contains
W-2 Employee (version 2)EmployeesCollected by our tax partner: Federal W-4; State withholding forms; SSN / ITIN; direct deposit / bank link. Completed by you: the Employer I-9 attestation.
Loan-OutLoan-outsCollected by our tax partner: W-9 (entity TIN); direct deposit / bank link
ContractorContractorsCollected by our tax partner: Individual W-9; direct deposit / bank link
VendorVendorsCollected by our tax partner: W-9; direct deposit / bank link

Every base item is required in the packet. On a payee's checklist, though, the tax-form rows (Federal W-4, State withholding forms, and the W-9s) say whether they're needed before payroll rather than Required: for an employee, Recommended before payroll; see Tax Information. A payee paid by paper check doesn't need a bank link: choosing paper check with our tax partner completes that item.

Form I-9 is now an employer attestation

Greenroom no longer collects Form I-9 or its supporting documents; your company completes and keeps the I-9 outside Greenroom. Each W-2 employee's packet carries an Employer I-9 attestation instead, which an Admin or Payroll teammate signs on the payee's page, confirming that your company received a completed Form I-9, examined the documentation presented, and determined the person is authorized to work in the United States. The packet isn't complete until it's signed, but payroll can continue while it's pending: the run's Employees & Loan-outs and Payroll Summary steps show Employer I-9 attestation pending with the number of payees, and each name links to that payee's Finish setup (with more than three, Show the N payees opens the list).

The Packets page itself, titled Onboarding packets ("Choose the forms and policies included in each start-work packet."), has two tabs, Templates and Document Library, with the Additional packet documents card below them.

Templates

A template is a base packet plus the Greenroom documents you add to it. When you assign a packet on a payee's page, the choices are the base packet for that payee's classification on its own (for example W-2 Employee · v2), listed first, followed by each active template that fits that classification. A base packet on its own adds none of your Greenroom documents, only the automatic ones, so pick a template whenever you want them included. Assigning a base packet on its own also adds a matching template with no documents to the Templates list, named after the base packet (for example W-2 Employee), which is reused for the next payee of that classification.

Production Default is created the first time you create a template here, pre-loaded with Greenroom's standard set (below). You can edit it, or create additional templates (a touring production's startwork versus a resident company's, for example) and choose between them per payee (see Payee Onboarding).

The Templates tab is a two-pane layout: your templates on the left (with an Active/Archived filter), and the selected template's editor on the right.

Editing a template

FieldNotes
Template name
DescriptionShown only to your team — payees never see it.
Base packetDefault for the payee's classification (the usual choice, and what Production Default uses), or one specific base packet such as W-2 Employee · version 2. When you choose a specific one, the editor lists what it contains, each item marked collected by our tax partner or Completed by the employer, and Required or Optional. A template tied to one base packet is only offered for payees of that classification.
Invitation email opening messageYour own note to the payee, up to 2,000 characters. When a payee's packet comes from this template, the invitation email Send to payee sends opens with it, right after the greeting, with your line breaks kept. A resend uses the template's current message.
Greenroom documents (signed in this order)The ordered list of documents this template adds (see below).

Add documents from the Add a document… menu, which offers Standard documents and System forms (Greenroom's built-in library, below) and your own company documents (PDFs you've uploaded — see Document Library). When the template names a specific base packet, the menu also lists, for reference, the forms our tax partner collects in it. The menu ends with New document in the library…. Reorder with the up/down controls; documents sign in this order. Each document carries a badge (applies automatically when relevant for a system form, Standard, or Library PDF), has a Required toggle, and can be removed from the template entirely.

Click Save template to apply changes, or Discard changes to drop them. A template with unsaved edits shows an Unsaved badge, and switching to a different template while you have unsaved changes prompts you to confirm before discarding them.

Editing a template only affects future packets. A packet already assigned to a payee keeps a frozen snapshot of the template as it was at that moment, and the editor says so: "Changes apply to future invitations. Sent start-work packets keep their original documents." Some of a packet's additional documents can still come off after it's assigned; see Taking documents off an assigned packet.

Templates aren't deleted, only archived (and un-archived any time via Restore) — archiving removes a template from the picker for new invites without touching packets already sent from it.

The built-in document set

Greenroom ships with these standard documents and system forms, available to add to any template:

DocumentApplies to
Form W-9 (Request for Taxpayer Identification Number and Certification)Older packets, in practice. In a start-work packet, loan-outs, contractors, and vendors complete their W-9 with our tax partner as part of the base packet, so this Greenroom copy is left out; W-2 employees never get it.
Direct Deposit (ACH) AuthorizationAnyone paid by direct deposit (skipped for paper-check payees)
Child Performer Trust Account — Payment AuthorizationMinor employees, only in states with a child-performer trust statute. In a start-work packet it gives way to the Child trust authorization additional document, which covers any payee under 18.
Representative Payment AuthorizationAnyone with a representative (agent/manager) on file — one copy per representative
Anti-Harassment Policy AcknowledgmentEveryone. In a start-work packet it gives way to your own Anti-harassment policy (see Additional packet documents), so nobody signs both. It gives way even while your policy isn't published, so a start-work packet asks for neither until you publish yours.
Notice of Pay Rate and Payday (NY Wage Theft Prevention Act)Everyone, for New York–based companies only. A W-2 employee of a New York company gets the New York wage notice additional document in its place.

Form I-9 is no longer in this set; see the callout above.

You don't have to track this conditionality yourself — Greenroom checks each payee's classification, payment method, age, and representatives automatically when the packet is assigned and drops whatever doesn't apply. A document that gets skipped for a particular payee is listed under their packet with the reason, rather than as something they owe; it isn't an error.

Company-level tax filing authorizations (IRS Form 8655 and state equivalents) are not part of this document set; they aren't payee onboarding documents. Your company's authorized signer e-signs them from the signing link sent from the Payroll signer and history stage, which is on Settings → Company once Greenroom has approved your setup. See Tax Authorization Forms.

Document Library

Your own company's PDFs — riders, handbooks, policies — available to add into any packet template. Upload a PDF (title defaults to the file name if you leave it blank); files are capped at 10 MB and must actually be PDFs. A payee acknowledges an uploaded library document with a typed-name signature, the same as any other packet document. The consent sentence beside that signature names the document by its title ("I have read and agree to the terms of your title, and I intend my typed name to constitute my electronic signature."), so give each upload a clear title.

If the title shows the file is a form our tax partner already collects (a W-4, an IT-2104 or a W-9), Greenroom asks first: "Our tax partner collects this form from each payee automatically — you don't need to upload it. Upload anyway?" A blank Form I-9 gets "Greenroom's packet already covers Form I-9 through the employer attestation — you don't need to upload the blank form. Upload anyway?" Choose Upload anyway or Cancel upload. Only the form itself triggers this; a rider or instruction sheet that merely mentions a form doesn't.

An upload that stops with "That upload could not be verified." adds nothing: the PDF Greenroom received isn't the upload it set up for your company's library. Switching to another company in another tab while the PDF uploads can cause this. Reload the page, check it shows the company you meant, and upload the PDF again.

The library table shows Title, Uploaded by, Date, and Size, with an Active/Archived filter. Archiving a document removes it from new templates but doesn't break anything already sent: "Documents already sent in a packet keep working after you archive them here — archiving only removes them from new templates."

Additional packet documents

Some documents attach to a payee's start-work packet automatically, by rule, whichever base packet or template you pick:

Additional documentWho gets it
Anti-harassment policyEveryone, once your company has published it
Confidentiality agreementEveryone, once your company has published it
Child trust authorization and Parent / guardian permissionAny payee under 18 on the date their employment starts
Manual payment certificationAnyone paid by paper check
New York wage noticeW-2 employees of a New York company
A union retirement electionW-2 employees whose union and agreement have a retirement plan set up in Greenroom. The IATSE Annuity Fund and Local 764 401(k) paper deferral forms are optional for the employee.

The Additional packet documents card below the tabs ("Company documents and production guardian settings") holds the text and settings three of them use:

  • Production guardian count: the number of child guardians named in your production's authorization. Zero is allowed. Save it with Save guardian count.
  • Guardian permission, Anti-harassment policy, and Confidentiality agreement: each shows its current version and effective date, or Not published. An unpublished company policy also says what that means, for example "Anti-harassment policy isn't published, so start-work packets leave it out. Once it's published, new packets include it; to ask a payee who already has a packet, open Startwork documents on their Finish payee setup and use Request a document." Author document (or Create new version once one exists) opens the Document text and an Effective date; Publish version N publishes it. Guardian permission starts from Greenroom's standard wording and has to keep its four placeholders (employer, production, and the guardian count in words and in numerals), which fill in from your company name, your show name, and the guardian count. The other two have no standard wording; they're your company's own policies.
  • View version history shows the text of every published version.

Publishing a version

Published versions never change. As the card puts it: "Publishing a new version preserves all past signatures. Request its acknowledgment from a payee's setup page when they need to sign the updated document." A packet that already holds a published version keeps it, and a signed copy stays as signed; to have a payee sign a newer version, open their setup page and use Request a document, then Request current version. Requesting sends nothing by itself; when the payee completes their packet by emailed link, Send to payee emails it.

Publish your policies before you assign packets

The anti-harassment policy and confidentiality agreement are your company's own documents, and Greenroom has no standard text for either. Until you publish one, a start-work packet assigned in the meantime leaves it out, so the payee isn't asked to sign it. Saving the payee's details doesn't add it either, and Request a document doesn't offer it; a request sent from a page opened earlier is refused with "Anti-harassment policy isn't published yet, so it can't be signed. Publish this company's document in Onboarding packets, then request its current version here." Once you publish it, new packets include it. A packet that left it out gets it the next time the payee's details are saved, on their record or in the personal details step of their setup, unless you've taken it off their packet (below); to ask one payee straight away, request it from their setup page.

An older packet can still hold an unpublished copy. Its row reads The company policy has not been published yet. on your side, and the payee doesn't see it. The payee can still finish and submit their setup, but it can't be approved, by you or automatically, until they've signed: the packet stays Needs review, and their Finish payee setup page says why, for example "Not approved yet: Anti-harassment policy and Confidentiality agreement are waiting on the company before the payee can sign. The start-work packet shows what each one needs. Approve once they are signed." Publishing the policy hands the published version to every such copy that isn't signed yet, as part of the publish itself. The payee then signs it from their own setup, and you approve; until they have, if they've already submitted, their Finish payee setup reads, for example, "Approval is on hold: the payee hasn't signed Anti-harassment policy yet. They sign it from their own setup. Approve once it is signed.", and Approve setup waits. A version you publish with a future effective date that also falls after a payee's start date reaches their copy at the first save of their details once it applies to them. If a contractor, loan-out or vendor doesn't need the policies, take them off their packet instead (below).

The same goes for minors: set the production guardian count here, and a show name in Settings → Company, before assigning a minor's packet. Otherwise their guardian permission waits with The production must set its guardian count and permission template before signing., and holds their approval the same way. If the packet is already assigned, set both: the save that completes the pair hands the completed version to every such copy that isn't signed yet, as publishing does for a policy, and their parent or guardian then signs it from the payee's setup page. Until both are saved, Request a document says what to save first instead of adding it.

Taking documents off an assigned packet

A packet's additional documents can come off after it's assigned, without assigning a new packet. Nothing signed is ever removed.

One payee. On the payee's page, open ⋯ at the top right of their start-work packet card and choose Change packet. The dialog lists the packet's additional documents. Uncheck the ones to take off and click Save changes; the page confirms with, for example, "Removed from this packet: Anti-harassment policy, Confidentiality agreement." A document that has to stay is greyed out, with the reason under it. The Startwork documents step of the payee's Finish payee setup offers the same thing one document at a time, as Remove from this packet.

Many payees. On the Additional packet documents card, the Anti-harassment policy and Confidentiality agreement rows each have Take off payees' packets. It lists your active contractors, loan-outs and vendors who still have that policy left to sign, leaving out any whose engagement classifies them as an employee, since an employee keeps it. Tick the ones who don't need it, or Select all, and click Take off N packets. The row then reads, for example, "Taken off 2 packets: [name], [name].", naming them when there are three or fewer. Anyone who signed it in the meantime keeps it and is named with the reason. If something unexpected stops one payee's removal, the others still come off, and the dialog lists that payee as "[name] keeps it: Something went wrong taking it off. If they are still listed, try again." A payee who hasn't been assigned a packet yet isn't listed: assign the packet first, then take the policies off.

DocumentCan it come off?
Anti-harassment policy, Confidentiality agreementYes, for contractors, loan-outs and vendors. An employee keeps both: Kept for employees.
A document you requested that the payee isn't otherwise dueYes
Anything already signedNo: Signed. The signed copy stays on record.
Manual payment certificationNo, while the payee is paid by paper check
Child trust authorization, Parent / guardian permissionNo, while the payee is a minor
New York wage noticeNo
A union retirement electionNo. The IATSE Annuity Fund and Local 764 401(k) paper deferral forms stay too, as the payee's own optional election.

A removal holds. Saving the payee's record later doesn't put the document back; it returns only if you request it again, or if the payee becomes an employee. To put one back, open Startwork documents on the payee's Finish payee setup, choose Request a document, then Request current version. Taking documents off an approved payee's packet leaves their approval in place, and the change never approves anyone by itself.

Next Steps

See Payee Onboarding for what a payee experiences when signing a packet, Company Settings for whether completed packets are approved automatically, or Team for who has access to configure any of this.

On this page