E-File Magic

Filers & recipients

Create and manage filers

Set up the businesses or payers you file for, choose your active filer, and prepare their records for recipient and order work.

Illustration of three blue business folders with distinct simple building silhouettes and a blank payer identity card.
In this guide

Selected and active are different

Opening a filer card changes the detail pane. Activate, or a successful save for a non-archived filer, updates Current Active Filer for recipient and order work.

Continue to recipient work

Before you start

The right organization

Confirm your workspace and the business or payer you are preparing.

Filer type and filing year

Choose both before saving and adding recipients.

Legal and contact details

Have the name, address, Tax ID, and telephone number ready.

View all setup requirements
  • Confirm you are in the correct organization workspace.
  • Choose the filer type that matches your forms: 1098, 1099, 3921, 3922, 5498 & W-2G Filers or 1042-S Class Filer.
  • For a new 1042-S filer, have both Chapter 3 Status Code and Chapter 4 Status Code ready. Enter them under Company / Filer, in Tax & withholding, before saving. Follow the required fields shown when editing an older filer.
  • Decide whether the filer should be entered as a Business or an Individual when the selected filer type shows Entity Type.
  • Collect legal name, address, the correctly punctuated tax ID, and contact details for the filer.
  • Expect the Company / Filer fields to change when you choose a different filer type.
  • Choose the filing year before adding recipients. You can change the year on a new or empty filer and save it after reviewing the fields for that year. Once the filer contains any recipients, including archived or unreleased recipients, Filing Year is disabled without an additional notice.
  • Copy forward is available only for a saved filer whose filing year is earlier than the current supported filing year.
  • Review the lock notice before editing. Released-recipient history locks filing details for all filers, including migrated filers. Use Copy filer for separate future work.
  • If you need to add notes, save the filer first so a filer ID exists.
  • Delete filer runs are asynchronous and can take time for very large filer populations.
  • A filer cannot be deleted once any of its recipients have been released for processing. This also applies to migrated filers.
  • A filer can run only one delete, copy forward, import, or order-preparation job at a time. Wait for the current background work to finish before starting another.
  • Merge Duplicates combines only eligible unreleased recipients and excludes records that contain only 3921/3922 merge-ineligible forms.
  • When you copy recipients to another year or change a recipient name or Tax ID, TIN matching is checked again for that exact combination. An available result from the past 300 days can fill in automatically without a new matching charge. Otherwise the record starts without the prior result and can be included in a TIN matching order once its details are ready. Completed results stay on unchanged historical records. Wait for an in-progress match to finish before changing the name or Tax ID.

What do you need to do?

Find a task, then follow its complete instructions.

Cancel a new filer

Return to the record you were working on without saving the new entry.

  1. Cancel the draft

    After choosing New filer, select Cancel immediately to the left of Save.

  2. Return to the previous filer

    The new draft is discarded and the previously selected filer and tab reopen.

No new filer is saved. Cancel is hidden when there is no previous record to return to and is unavailable while saving.

Page details and controls
Screen Title Section

The shared workspace title section identifies the Filers screen above the filer directory and detail workspace.

Directory Controls

Left panel controls include New filer, Search, Sort By, Filing Year Filter, Refresh, Rows, Previous/Next paging, and list summary. Returning to Filers refreshes the current directory page, including newly imported filers. Existing filters still apply.

Directory Cards

Each card shows filer name, location, filing year chip, updated time, status badges, and Activate when eligible.

Directory Paging

Compact controls in the directory status bar provide Rows and Previous/Next page navigation above the records.

Detail Header Actions

The working-filer header shows the filer name beside a building icon, followed by Tax Year, Revision, and applicable status badges. The full-width Filer details locked notice explains when released recipients prevent editing. The compact detail header groups Copy filer, Actions, and the primary Save button. Open Actions for Activate, eligible Copy forward, and the visually separated Delete filer choice. Saving changes… appears while Save is in progress. If you choose another page during the save, the page opens after the save succeeds. If saving fails, you stay in the editor with your entered values. All changes saved confirms completion. Unsaved changes shows Reset or Revert only when the draft differs. Alerts explain when background work or released recipients temporarily make details read-only. While copying, Cancel copy replaces Copy filer and remains available even before you edit a field. It discards the copy and returns to the original filer and tab. It is unavailable while Save is in progress and disappears after the copy is saved. Delete filer is grayed out when recipients have been released for processing; the explanation appears beneath it in Actions. After choosing New filer, Cancel appears immediately to the left of Save when there is a previously selected filer to return to. Cancel discards the new entry and restores that saved record and its prior tab, even before any fields are entered. It stays hidden for the first record and is disabled while saving.

Detail Tabs

Use Company / Filer for core filer fields, Additional Information for contact details, generated Filer Code, Display Name, and e-delivery recipient contact details, Notes for filer-level note history, and Mass Changes to review and merge duplicate recipients. Tabs show validation-error counts after a failed Save, and the first affected tab opens automatically. Filing Year stays locked while checking for recipients. If that check fails, click Refresh in the filer directory. If fields fail to load after a year change, select the original year or click Revert. Validation Issues lists saved import problems and issues in your current edits; select an issue row to jump to the field that needs attention. The 1099-class Company / Filer form has three sections: Filing identity, Legal name & address, and Filing settings. Filing identity contains Filer Type, Filing Year, Entity Type and Tax ID. Use Foreign Entity in Legal name & address to show the appropriate address fields. In Filing settings, enter Telephone Number, set Last Year Filing, and choose Yes for Include Transfer Agent when agent details are needed. Those details appear directly below that choice. Both filer classes use the same compact panels and controls in Company / Filer and Additional Information. Additional Information remains editable when you have access to change the filer. Locked filing details keep their bordered input, dropdown and selection controls within the same compact groups. Recipient Contact Name and Recipient Contact E-Mail remain inputs for e-delivery. Change either and click Save; filing details and existing filing history stay unchanged. Copy filer opens an editable draft. Generated identifiers and system record values are always read-only.

Working Context

Current Active Filer in the top bar scopes recipient, import, and order work. Saving a new filer, including a Copy filer draft, automatically selects that filer and its filing year before you continue. This works even when the directory search, year filter, or page does not show the new filer. Selecting a row or changing Filing Year Filter leaves the active filer unchanged; Activate and a successful Save for a non-archived filer update it. An unsuccessful save keeps the previous active filer.

Mass Changes

The Merge duplicate recipients panel explains how records match and which forms are excluded. Click Review duplicates to choose which details to keep and combine amounts. Opening the review does not merge any records. Save a new filer first; existing validation or recipient-processing locks must be resolved before review is available. Import and processing notices appear only when they apply.

Actions while scrolling

On desktop, Copy filer, Actions, Save, and the save status with Reset or Revert automatically move into a bar below the main header when you scroll past them. The bar shows the record you are working on and stays within reach as you continue down the form. Scroll back up to return the controls to the detail header. On smaller screens, these controls remain in the detail header. Saving and sending still require a click and the usual completed fields and permissions; unavailable actions stay unavailable. Cancel copy stays with Save in this bar while a copy draft is open.

Validation Issues

Review saved import or migration issues and current Form issues together. The summary shows the number of issues and affected fields. Select a row marked Go to field to open Company / Filer or Additional Information and focus its field. General issues without a field remain available to read. The tab remains available for read-only filers, but their edit restrictions still apply. For a new or copied filer, only fields you have interacted with show errors until you select Save. No validation issues means no issues are currently shown; Save still checks all required details. Saved filers show their existing issues immediately. If fields are unavailable, a loading warning appears instead. Save corrected details to clear saved import issues; failed saves retain them. INLINEF imports can retain filers with missing or invalid details so their recipient rows can finish importing. Complete the import, then repair these filers here before continuing recipient work or filing. Save is available for a saved filer that needs review even when its details have not changed. Confirm the details and Save; failed validation leaves the issues visible.

Statistics

Review Released, Validated, Not validated and Corrected form counts for the selected saved filer and its saved filing year. The validation chart shows the validated share; the release chart compares up to six largest form types. Counts by form type includes every type and an All forms total. Counts describe forms, so one recipient can contribute more than one form. These counts can overlap: a corrected form can also be validated and released. Validated means the application checks passed, not IRS acceptance. Select Refresh for new totals. During an import or when totals are updating, the panel waits and refreshes automatically while visible. New and copied drafts need to be saved first; save or discard an unsaved filing-year change before viewing statistics. An empty directory clears this panel with the other details.

Keyboard dropdown selection

Tab into a searchable dropdown and type a name or code, such as AL in State. Press Down Arrow to highlight the first matching choice; use Down Arrow or Up Arrow to move through the available choices, then Enter to select. The highlight is outlined and shaded, and unavailable choices are skipped. Escape closes the list and restores the current selection; Tab moves to the next field. If there are no matches, edit or clear the search. You can still click a choice or use the down-arrow button. Locked fields remain read-only. Choosing a value does not click Save.

Actions and controls
  • Click New filer to open a filer draft in the detail pane. Tax ID briefly glows and receives the text cursor when the browser permits, showing where to begin. Available profile details fill the filer-contact, notification-email and recipient-contact fields. Enter the separate Telephone Number under Company / Filer before saving. After Save succeeds, the new filer becomes Current Active Filer and its filing year appears in the top bar.
  • Empty filer data-entry fields are intentionally blank. Labels and field guidance explain what belongs there without showing sample names, addresses, Tax IDs, phone numbers, or emails that could be mistaken for saved data. New and copied drafts do not show validation errors before you interact with their fields. As you work, errors appear for the fields you have touched; Save checks the whole draft. Reset clears draft errors and restores the starting values.
  • Use the filer search box to find a filer by name, code, location, contact values, or tax-id related values.
  • Use Sort By to switch between newest/oldest updated records. When a search term is entered, Relevance is also available.
  • After the filer directory loads, the first visible filer is auto-selected and shown in the detail pane.
  • Use Filing Year Filter to narrow the left directory to one supported year or All years without changing global Current Active Filer. The filer screen opens with this filter set to your active filer’s year, or the latest supported filing year when no filer is active. Refresh keeps your selected filter; changing the active filer updates the initial year for that context. Choose an earlier year or All years when needed.
  • Click Refresh in the directory to re-request the current filer list.
  • Click a filer card to load it into the right-side detail pane without changing global Current Active Filer.
  • Open a filer directly from workspace search links (/i/filers?filer_id=<id>) to load that exact filer in the detail pane.
  • Click Activate on a filer card, or open Actions in the selected filer header and choose Activate, to make that non-archived filer the global Current Active Filer.
  • If the organization has exactly one non-archived filer and no Current Active Filer is stored, the filer screen can activate that filer automatically on initial load.
  • Use the compact Rows control with Previous/Next in the directory status bar to page through results without taking space away from the records.
  • Open Actions in the detail header and choose Delete filer to queue permanent background deletion. Once accepted, a brief confirmation appears, that filer is removed from ordinary lists immediately, and, if it was Current Active Filer, another available filer becomes active or the selection clears when none remain. The protected delete then finishes in the background without placing a deletion notice on the replacement filer.
  • Use Copy filer beside Actions to start a new filer draft prefilled from the current filer. Cancel copy appears beside Save immediately. Click it to discard the unsaved copy and return to the original filer; Current Active Filer stays unchanged.
  • When the selected filer is from an older filing year, open Actions and choose Copy forward to 2026 to queue a background copy of the filer and its recipients into the current filing year.
  • Copy forward includes all recipients. Include unreleased W-2G and 1098-C details is selected by default; only those forms from the immediately preceding year retain compatible details. All other forms copy common recipient information only. Changed or unavailable fields are flagged for review.
  • When the draft differs from its starting values, use Reset (create mode) or Revert (edit mode) beside Unsaved changes to discard those edits.
  • Use Save to create or update the filer currently shown in the detail pane; choose Filer Type before the first save. Editable selectors, including Filer Type, show a graphical down-arrow at the right edge so it is clear that the available choices can be opened. If validation fails, the screen opens the tab containing the first problem, focuses that field when possible, shows the exact validation messages, and adds error counts to the affected tabs.
  • Use Additional Information to set the recipient contact name and optional email shown on e-delivery notices. These two fields stay editable with filer-management access even when filing details are locked. Save applies the contact change without changing IRS filing data. New-filer contacts default to your profile name and email. You can replace those defaults; loading profile details does not overwrite a contact you have edited or cleared, and saved filers keep their existing contact information.
  • For 1099-class and 1042-S filers, choose Business or Individual in Filing identity beside Tax ID. Business uses Name 1 and Name 2; Individual uses First Name, Middle Name, Last Name, and Suffix. Name 2 and Suffix remain optional. Enter each part of an individual’s name in its own field.
  • Save records the filer information used throughout the workspace. E-File Magic prepares the required IRS filing records later when an order is released.
  • Copied-forward records are intentionally marked for review so you can confirm current-year compliance and accuracy before using them.
  • Switch tabs with Company / Filer, Additional Information, Notes, Mass Changes, and Validation Issues.
  • In Additional Information, filer contact names for current filing-year forms may contain letters A–Z, digits, straight apostrophes, hyphens, and single spaces. First and last names together, including the separating space, may contain up to 35 characters. For example, Ann O'Neil is accepted. Older records follow their saved form requirements. If a saved import issue remains after correcting the name, click Save to validate and clear it.
  • Fields and validation messages follow the selected filer type and filing year. Telephone Number under Company / Filer is required when saving. Filer Contact Phone under Additional Information is separate; follow the requirements shown for that field.
  • After a filer is saved, Filer Type is locked and shown as read-only. Use Copy filer or New filer if a different filer type is needed.
  • Country Code and Province Code appear only when Foreign Entity is set to Yes; domestic filers use City/State/ZIP and do not submit a foreign Country Code value. For a domestic filer, choose State from the same searchable state list used for recipients. Search by state name or abbreviation and select a listed option. This applies to both 1099 and 1042-S filers.
  • Use Add Note, Refresh, and Load more in the Notes tab for filer-level note history once the filer is saved and not locked by another protected filer workflow.
  • Archived filer records are retained for review and cannot be edited from this workspace. Available and disabled lifecycle status is managed by the system and is not edited on the Filers screen.
  • When an import, order preparation, copy forward, filer delete, or count refresh is active, the filer becomes read-only and shows an alert until that work finishes.
  • Filers with released recipients show a lock notice and keep filing details and Save disabled, including migrated filers. Use Copy filer to start a separate filer when payer details need to change. Delete remains blocked by released-recipient history. Recipient Contact Name and Recipient Contact E-Mail remain editable for e-delivery.
  • For 1099 Class filers, E-File Magic automatically detects EIN, SSN, or ITIN when the Tax ID uses normal punctuation: XX-XXXXXXX is an EIN, XXX-XX-XXXX is an SSN, and IRS-assigned 9XX-XX-XXXX ranges are ITINs. An unpunctuated Tax ID remains valid and leaves the exact type unset. Entity Type controls names only and never guesses the Tax ID type.
  • Read Created and Updated timestamps in your local timezone.
  • Open Mass Changes tab for recipient cleanup tools on the selected filer.
  • Open Actions and choose Delete filer to permanently remove the filer, all associated recipients, their records, and related files. Review the warning and choose Cancel to keep them. Delete filer is grayed out with an explanation when recipients have been released for processing.
  • Click Review duplicates in Mass Changes to open the Merge Duplicates dialog. Matching rules show that both Tax ID and form type must match; Forms 3921 and 3922 are excluded. The review opens one group at a time so very large accounts remain responsive.
  • For each duplicate Tax ID + form group, merge candidates one-by-one into a survivor record, combine currency fields additively, and apply field-level left/right choices when form detail conflicts require manual resolution.
  • When you apply a merge batch, the server rechecks release/version state and commits the survivor update plus up to two duplicate deletes together; larger groups reload so you can continue with another batch.
  • Forms 3921 and 3922 are intentionally excluded from merge operations, released recipients are skipped, and oversized duplicate groups are skipped from interactive review instead of loading every member into the modal.
  • Look for Migrated on the directory card and detail header to identify records brought forward from the old system. Migrated filers with released-recipient history keep their filing details locked. Unreleased migrated filers can be edited when no other lock applies. Its tax year and filer type stay fixed; use Copy forward for a new year. Before filing a correction, the filer details must match the previous filing. If processing reports a mismatch, contact support to review the saved filing history. Contact support for the separate IRS process if the filed issuer name or tax ID was wrong.
  • Filers marked Needs attention list their issues in Validation Issues. Its badge shows the number of distinct issues. Migrated or Imported labels identify saved issues, and Form labels identify issues in your current edits; the same issue can have both labels. Select an issue row to open its section and focus the field when Go to field is shown. Correct the details and Save. Saved import issues remain listed until saving succeeds. Until then, recipients remain readable but cannot be added, edited, deleted, merged, copied forward, imported into, or released in an order. Recipient, order, and spreadsheet import screens show one compact notice with a Review issues link to this tab; field-by-field details stay here. Order submission stays disabled until the filer is repaired, without repeating the same validation problem as a separate workflow error.
  • These data-entry fields ask your browser not to autofill saved details, reducing the chance of unrelated personal information appearing in the record. Saved E-File Magic values and deliberate application defaults still load normally. Your browser or password manager may override this preference.
  • Open Statistics, to the right of Validation Issues, to review form counts and graphs for the filer selected in the detail pane. This does not change your active filer.
  • In the Filers and Recipients directories, matching parts of the visible name and location are highlighted in blue after search results load. Clear the search to remove the highlights. A match in details that are not shown on a card may have no highlight; click the card to review the record.

If you get stuck

Save fails with highlighted errors.

Read the exact messages in the Unable to save filer alert. E-File Magic opens the first affected tab, focuses the first invalid field when possible, and shows an error count on every affected tab. Correct those fields, then save again.

I cannot find a filer I expect to see.

Check Filing Year Filter first, then clear search text or click Refresh. After an import, return to Filers; the directory refreshes automatically. Check Search and Filing Year Filter if a newly imported filer is outside the visible results.

A filer shows Needs attention and recipient or order actions are unavailable.

Open the filer and select Validation Issues. Select an issue row to find its field, correct the details and Save. A successful save clears the saved filer issues and allows recipient work again. Existing data stays available to view.

I saved a new filer, but it is not in the current directory results.

Check Current Active Filer and its filing year in the top bar; the saved filer is selected automatically. Clear the directory search, choose All years, or change pages to find its card. If Save showed an error, correct the highlighted fields and save again; the previous active filer stays selected until saving succeeds.

More troubleshooting (23)
An address line is rejected even though the street address is correct.

Read the message beside that address line: it identifies unsupported punctuation, pasted characters, extra spaces, or a starting or ending character that needs attention. For example, enter St instead of St. and PO Box instead of P.O. Box. Replace an apartment number sign with Apt or Suite as appropriate. Keep meaningful hyphens and slashes, such as 24-26 or 1/2. Use one space between words, correct the highlighted line, then Save. These messages also apply to additional addresses within a recipient form. Your address is not automatically rewritten.

I clicked Copy filer by mistake, or Reset did not leave the copy.

Click Cancel copy beside Save to return to the original filer without creating a new record. Reset only restores the copied draft’s starting values. Cancel copy is available until the copy is saved, except while a save is in progress.

I cannot click New filer, Save, Delete filer, or Copy filer.

Wait for any active save, load, or filer workflow to finish, then retry. If actions remain disabled, ask an account administrator to confirm your role includes filer edit access.

I clicked Save, but the button is disabled.

Save is available for a new filer, changed details, or a saved filer with validation issues. If disabled, check your permissions, the lock notice, and whether field definitions are still loading. A filer that needs review does not require a temporary type or Tax ID edit before saving.

I do not see Copy forward to 2026 in Actions.

Copy forward appears in Actions only for a saved filer whose filing year is earlier than 2026. Select an older-year filer first. If the filer is already in a protected background workflow, wait for that work to finish.

Activate is not shown on a filer card.

Activate appears only for non-archived filers that are not already Workspace Active. Refresh or change Filing Year Filter if needed, then open the filer in the list or detail pane.

Changing Filing Year Filter moved the detail pane to a different filer.

Filing Year Filter only changes which filer rows are visible in the directory. It does not change Current Active Filer. Use Activate on the intended filer if you want to switch the workspace context.

Fields are locked in the detail form.

Read the lock reason in the header. Filing details may be frozen by release history, processing, or historical-record restrictions. Recipient Contact Name and Recipient Contact E-Mail in Additional Information remain editable with filer-management access. Change these e-delivery contact details and click Save. A contact-only save does not clear filing validation issues or change IRS filings.

I cannot change Filer Type on a saved filer.

Filer Type is locked after the filer is saved. Use Copy filer or New filer when a different filer type is needed.

A Company / Filer field I expected is not displayed.

For a new filer, confirm Filer Type before the first save because it cannot be changed afterward. If the expected fields do not appear or the screen shows a field-loading warning, refresh and try again.

I cannot add notes.

Save the filer first, then return to Notes and click Add Note. If an import, order preparation, copy forward, filer delete, or count refresh is active, wait for that work to finish.

Review duplicates is unavailable.

Select a saved filer, resolve any issues in Validation Issues, and wait for saving or active recipient processing to finish. You need permission to manage filers. Any import or processing notice explains what must finish first.

Delete filer is unavailable before I confirm the delete.

Read the explanation beneath Delete filer in Actions. A filer with recipients released for processing cannot be deleted. Otherwise, wait for active background work to finish, resolve any issues in Validation Issues, and check that you have permission to manage filers.

Delete filer is blocked.

One or more recipients have been released for processing, so this filer must be retained. Close the message and review the recipients if needed. Migration history does not remove this restriction.

Delete filer disappeared from the list but related records still exist.

That is expected while the protected delete is running. The filer is hidden immediately so it cannot be edited or selected; recipient, note, print-export, and search cleanup continues durably in the background.

Delete filer finished but the filer still shows in workspace search.

Refresh search after the background delete run finishes. The delete workflow also clears filer and recipient search entries, and older background sync work does not restore deleted hits after cleanup completes.

Copy forward says the current-year filer already exists or is already processing.

A current-year copy has already been created or a prior copy-forward job is still running for that filer. Open the current-year filer if it already exists, or wait for the existing background job to finish.

I need to archive a filer.

Filer archiving is currently unavailable. Open Actions and choose Delete filer only when you intend to permanently remove the filer and its related records.

Merge Duplicates shows fewer groups than I expected.

Only eligible unreleased recipients are grouped when both normalized Tax ID and form type match, and records with 3921/3922 forms are excluded. The modal loads one group at a time and skips oversized groups instead of loading every member at once. Before applying the merge, E-File Magic checks for newer changes; refresh and reload the group if someone else updated a record.

I cannot merge a duplicate because conflicts remain unresolved.

Use Left/Right field choices for each non-common conflict row in the modal, then merge the candidate again.

I corrected a field but its migrated issue is still listed.

Saved import and migration issues remain until Save succeeds. Click Save and resolve any remaining error. A failed save does not clear the Needs attention status.

My newly saved copy does not appear immediately in the directory.

A successful save refreshes the first directory page and keeps the new copy visible and selected while the list updates. You should not need to refresh manually. If a list refresh fails, the saved copy remains available and the directory shows its loading error.

The phone number printed on a form is wrong or is my personal number.

Select the correct filer and year, then open Company / Filer. Change Telephone Number in Filing settings, or in Contact if you file Form 1042-S, and select Save. Use a valid business contact number; this field cannot be left blank. Preview a fresh PDF to check it. Profile, Security phone and Additional Information Filer Contact Phone are separate. If the filer is locked or an order has already been submitted, contact support about the available change. Even when you can edit the filer, this does not replace forms already filed or mailed. Do not submit another original just to change the phone number.