Offline user manual · Version 5.3.0

Paystub Suite Help Center

Learn each workflow, button, safeguard, and export option. This guide is stored with the app and remains available offline.

Batch guide

Find an answer

Search this help guide

Showing the complete guide.

Guided tour, fictional demo, and sample PDF

Select Quick tour in the app header to reopen the six-step introduction at any time. On a new installation, it appears after the encrypted-vault and donation prompts are dismissed.

Load fictional demo

  1. Select Load fictional demo from the tour.
  2. The app fills the form with clearly labeled example information and displays a red demonstration banner.
  3. Explore worker types, line items, YTD fields, batch controls, and tax/compliance sections.
  4. Select Clear demo before entering real records.
The demo is not authorized for generation. It uses fictional values, a DRAFT status, and a “DEMO - NOT FOR USE” watermark. Use the bundled sample PDF to inspect finished output.

View sample PDF

The sample PDF is bundled with the app and works offline. It contains fictional data and can be opened without entering or saving any payroll information.

Start here

Quick start: create one statement

  1. Select and unlock a named encrypted vault with its passphrase, create a new vault, or choose Use private session if nothing should persist after the app closes.
  2. Under Document setup, choose the worker type, document status, template, paper size, currency, locale, and document language.
  3. Enter the employer/payer and worker/payee information. Uploading a logo is optional.
  4. Set the pay frequency, pay-period dates, pay date, and payment method.
  5. Add all current-period earnings. Use Hours × rate for hourly work or Fixed amount for salary, bonus, commission, reimbursement, or other fixed earnings.
  6. Add actual deductions. The optional tax adviser can recommend amounts, but the recommendations must be reviewed before applying.
  7. Add optional employer contributions, leave balances, and year-to-date values.
  8. Review validation messages and check the authorization statement.
  9. Select Exact preview to inspect the PDF page before saving.
  10. Select Generate locally, then open, download, save, share, or export the first page as PNG.
Nothing is uploaded for PDF creation. The document, calculations, logo, profiles, and encrypted history are processed on the device. Recommendation updates are read-only rules data and contain no payroll information.

Detailed walkthrough

Batch payroll: create statements for multiple workers

Batch mode lets you prepare up to 50 statement snapshots, then create a ZIP containing a separate PDF for each worker plus a combined payroll CSV.

Recommended batch workflow

  1. Save an employer profile. Complete the employer section and select Save current under Company profile. This avoids retyping the same payer information.
  2. Load or create the first worker. Complete all worker, period, earnings, deductions, YTD, contribution, and leave information.
  3. Review optional tax recommendations separately for that worker. W-4 choices, prior wages, residence/work state, and local taxes may differ by employee.
  4. Check authorization and validation. Batch queue entries must pass the same validation as an individual statement.
  5. Select Add to batch. The worker appears in the Batch queue with pay date, gross pay, and net pay.
  6. Load the next worker profile or replace the worker fields. Adjust that worker’s earnings, deductions, YTD, tax inputs, and leave balances.
  7. Select Add to batch again. Repeat until all intended workers are queued.
  8. Review the Batch queue. Use Remove beside one entry to discard only that snapshot.
  9. Select Generate batch ZIP. The app creates one PDF per queued worker and a file named payroll-summary.csv inside the ZIP.
  10. Select Combined CSV when you need only the queue summary without generating PDFs.
Queued records are snapshots. Changing the form after selecting Add to batch does not update a previously queued record. Remove the old queue entry and add the corrected form again.

What is inside the ZIP?

Batch safety checklist

Document setup, worker types, and templates

Worker type

W-2 employee
Ordinary employee earnings statement. Tax adviser and payroll deductions may be relevant.
1099 contractor
Independent-contractor payment statement. Do not present recommendations as employer withholding unless legally appropriate.
Owner draw
Documents an owner distribution or draw rather than ordinary employee payroll.
Statutory employee
For workers treated under applicable statutory-employee rules. Confirm tax treatment separately.
Reimbursement-only
For a statement containing reimbursements rather than ordinary wages.

Templates

Professional, Compact payroll, Detailed itemized, Modern, Minimal, and Ledger change visual layout only. They do not change the underlying calculation or legal requirements.

Paper, currency, locale, and language

Paper size controls PDF dimensions. Currency and locale control symbols, decimal separators, and date formatting. Document language changes supported PDF labels. These choices do not automatically make a statement compliant in another country.

Profiles, backups, and data tools

Company and worker profiles

Encrypted backup

Creates a JSON backup protected by a separate passphrase. It can include the current draft, profiles, history, and batch queue. Remember the backup passphrase; support cannot recover it.

Import backup

Imports a compatible plain or encrypted JSON backup and migrates older supported schemas. Import replaces the current draft, profiles, history, and batch queue in the active vault.

Summary CSV and Text summary

These export a readable summary of the current form. They are not a replacement for the formatted PDF and may contain payroll information, so store them securely.

Pay-period controls

Always confirm semimonthly boundaries and actual payday policies; the date tools are conveniences, not an employer calendar or banking schedule.

Optional tax and compliance adviser

The adviser estimates 2026 federal withholding and FICA from the information entered, then provides a state estimate and local review notes. It is optional and does not automatically change the deductions section.

How to use it

  1. Enable the adviser.
  2. Confirm residence state, work state, work locality, filing status, W-4 entries, prior YTD Social Security wages, and prior YTD Medicare wages.
  3. Enter the worker’s taxable earnings in the Earnings section.
  4. Select Calculate recommendations.
  5. Read the assumptions, source links, effective dates, collection dates, bundle version, and signature status.
  6. Select Apply recommended deductions only when the recommendations are appropriate. Applied lines are fixed deduction snapshots and can be edited or removed.

Recommendation-data buttons

Location is not enough for exact payroll tax. Accuracy can also depend on W-4 elections, taxable-wage treatment, multiple jobs, prior wages, reciprocity, municipal boundaries, and employer records.

Expand Federal, state, and local compliance checklist to review advisory fields and official-source links. The collection date shows when the source was last reviewed by the catalog process.

Earnings, deductions, contributions, and leave

Add earning

Adds a line for regular pay, overtime, bonus, commission, piece rate, reimbursement, or another earning. Choose Fixed amount or Hours × rate. The Taxable checkbox affects the adviser’s taxable-wage input.

Add deduction

Adds tax, pre-tax, post-tax, garnishment, or other deduction lines. Fixed amounts are exact current-period values. Percentage deductions calculate from gross pay. Category labels do not by themselves perform a complete taxable-wage ordering calculation.

Remove

Removes that line. If the final earning line is removed, the app creates a blank earning line so the form always has an earnings area.

Add contribution

Adds employer-paid benefits or costs. Contributions increase displayed total compensation but do not reduce employee net pay.

Add leave type

Adds vacation, sick, PTO, compensatory-time, or another leave balance with accrued, used, remaining, and unit fields.

Year-to-date values and recurring items

Roll forward YTD totals adds the current period’s gross and deductions to the previous YTD gross and deductions. Use the prior completed statement, not another worker’s totals.

When roll-forward is disabled, enter YTD gross, deductions, and net manually. Line-level YTD fields can be shown for individual earnings, deductions, and employer contributions.

Optional settings

Original, corrected, replacement, voided, and draft statements

The record ID and document hash help identify and detect later modification of a file. They do not verify that the underlying employment or amounts are true.

Review, preview, generation, and exports

Generated PDFs are not retained inside the app automatically. Saving history stores a sanitized record, not the PDF bytes.

Recent statements and local analytics

Recent statements

Analytics

Analytics summarize only saved local history: statement count, gross, deductions, net, and monthly gross chart. They do not read PDF files or cloud payroll records. If history saving is disabled, those statements will not appear in analytics.

Encrypted vault and private sessions

The app asks how it should handle sensitive payroll information before the form opens. Both choices perform payroll calculations and PDF generation locally on the device. Neither choice uploads payroll records to the Paystub server.

Encrypted vault
Saves drafts, company and worker profiles, batch records, and statement history on this device as AES-256-GCM encrypted data. Every named vault has its own passphrase, encryption key, and isolated records. Your passphrase is never transmitted or stored by the app.
Private session
Keeps payroll form data only in memory for the current visit. The app does not autosave the draft, profiles, batch queue, or history. Refreshing the page, closing the app, or ending the browser session clears that information.

Using multiple vaults

  1. Choose a vault from the list on the entry screen and enter that vault’s passphrase.
  2. Select Create another vault to make a separate workspace. Up to 20 vaults can be stored on one browser or app installation.
  3. After unlocking, use Switch or create vault to lock the current vault and return to the chooser.
  4. Use Rename vault or Delete vault only after that vault has been unlocked.
Vault names are not encrypted. They must be visible before unlock so the chooser can display them. Use neutral names such as “Primary,” “Business 2,” or “Client A,” and do not put Social Security numbers, tax IDs, wages, or other sensitive details in a vault name.

Only one vault is unlocked at a time. Profiles, drafts, history, analytics, and batch records do not cross between vaults. Backups also contain only the currently unlocked vault’s exported data.

An existing single vault is automatically migrated to the list as Primary vault. Its encrypted payload and original passphrase remain unchanged.

What can remain after a private session?

Files you deliberately download, save, print, or share—such as a PDF, CSV, ZIP, image, text summary, or encrypted backup—remain in the destination you selected until you delete them. The installed app shell and non-payroll settings may also remain so the PWA can work offline.

Which option should I choose?

Passphrases and recovery

Use at least 10 characters and store the passphrase somewhere secure. The app has no account or recovery server, and support cannot read or reset the vault. An encrypted backup uses its own passphrase and follows the same no-recovery rule.

Storage controls

Passphrases cannot be recovered. Export an encrypted backup before erasing local data, and confirm that you know the backup passphrase.

Complete button reference

ButtonWhat it does
ThemeSwitches between light and dark appearance.
HelpOpens this offline Help Center.
Donate / Support the appOpens optional support choices. Payment does not unlock features.
Install appInstalls the PWA when the browser supports installation and the app is served securely.
Update nowActivates an already downloaded PWA application update and reloads the app.
Vault list / Create another vaultSelect an existing encrypted workspace or create a separately encrypted one.
Switch or create vaultLocks the current vault and returns to the named-vault chooser.
Rename vault / Delete vaultChanges the unlocked vault’s visible name or permanently deletes that vault after confirmation.
Load / Save current / DeleteManage the selected employer or worker profile.
Encrypted backup / Import backupExport or restore the vault’s portable data package.
Summary CSV / Text summaryExport the current form in tabular or plain-text form.
Upload logo / RemoveAdd or remove the employer logo; resizing happens on the device.
Set current / Previous / NextCalculate or shift pay-period dates.
Duplicate previous stubStarts the next statement from the latest saved history entry.
Check for updated sourcesDownloads a newer signed recommendation catalog if available.
Use bundled dataDiscards downloaded recommendation data and returns to the installed catalog.
Use device locationSuggests a likely state locally; the user confirms the jurisdiction.
Calculate recommendationsRuns the optional tax adviser without altering deductions.
Apply recommended deductionsAdds reviewed adviser results as fixed deduction lines.
Add earning / deduction / contribution / leave typeAdds the corresponding editable row.
RemoveDeletes the individual row or selected batch item.
Clear formClears the current draft but keeps profiles and history.
Add to batchStores a validated snapshot in the queue.
Exact previewDisplays the PDF before final generation.
Generate locallyCreates the final PDF on the device.
Open / Download / Share / Export PNGUse or export the most recently generated document.
Generate batch ZIP / Combined CSV / ClearExport or clear the queued multi-worker batch.
Load / Next periodReuse a saved history entry.
Clear historyDeletes all locally saved history records.
Erase current vault dataClears payroll records inside the unlocked vault without deleting its name or encryption setup.
Use private session / Unlock selected vaultChoose nonpersistent operation or open only the selected encrypted vault.
Continue free / DonateDismiss the optional support prompt or submit the selected tip.

System status, diagnostics, and retention

Open System status from the app header or footer to check offline readiness, encryption support, storage usage, recommendation freshness, policy links, location-permission state, and the local PDF assets.

Privacy-safe diagnostics

The diagnostic report contains app version, platform, browser capabilities, storage totals, policy-link configuration, and recommendation metadata. It intentionally excludes names, addresses, wages, tax IDs, document contents, vault contents, and precise coordinates.

History retention

  1. Choose how long to keep generated-statement history.
  2. Choose a maximum of 25, 50, or 100 records.
  3. Select Apply retention. Expired records are removed from the encrypted history, but exported PDFs and backups are not deleted.
Back up first: retention removal cannot be undone unless the records exist in an earlier encrypted backup.

Feedback and support packets

Open Feedback from the app header or footer to describe a bug, accessibility issue, tax-rule concern, store issue, or feature request.

Troubleshooting

The Generate button reports validation errors

Read the Review and authorization section. Common causes are missing addresses or dates, blank earning descriptions, inconsistent YTD values, missing correction record ID, deductions exceeding gross without acknowledgment, or unchecked authorization.

Add to batch does not work

Batch entries must pass validation. Complete the required employer, worker, period, earnings, YTD, and authorization fields. Correct the validation summary, then add again.

I changed a worker but the queued batch item did not change

Batch entries are snapshots. Remove the old batch item and select Add to batch again after making corrections.

Duplicate previous stub says no history is available

Generate a statement with Save non-sensitive details in encrypted local history enabled. The duplicate function uses the newest saved history record.

The tax recommendation seems wrong

Verify pay frequency, taxable earnings, W-4 fields, prior YTD Social Security and Medicare wages, work state, residence state, and local jurisdiction. Open the listed official sources and compare the recommendation with current payroll instructions.

The app is offline

PDF creation, profiles, encryption, bundled recommendations, history, batch, and exports continue to work. Donations, source links, and recommendation catalog refresh require internet access.

I forgot a vault or backup passphrase

There is no recovery server. Start a private session or create another named vault. Existing encrypted content cannot be recovered without its passphrase. Removing an inaccessible vault requires clearing this site’s app data through the browser or operating-system settings, which also removes every other vault stored by that installation.

The PDF opens but I cannot find it later

Use Download or Save PDF. Generation creates a temporary document until the user saves or shares it. History stores a sanitized record, not the PDF itself.

Storage is full

Export a backup, save needed PDFs elsewhere, clear unnecessary history or batch records, and use Erase current vault data or Delete vault only when you understand that the removal is permanent.

The installed PWA shows an older screen

Use Update now when the banner appears. Otherwise close all app windows, reopen while online, and allow the service worker to retrieve the new application shell.

Important limitations

Privacy policy · Support · Terms