Use Planning → Taxes → Returns to import a tax-return PDF, inspect extracted forms, and create a tax scenario from supported values. Importing a return doesn't file or amend it, and a completed extraction still needs an advisor's review.
How do I upload a client's tax return?
On a client's Planning → Taxes → Returns page, advisors can upload a new PDF or select one already saved for that household.
Select New Return, then Upload PDF.
Select Drop PDF here or click to choose, or drop 1 PDF into that area. Selecting a file starts the upload.
Enter its PDF password if prompted. An incorrect password must be corrected before upload can continue.
In a Where these go dialog, check Dora's choice for that PDF: a folder, Documents for the top level, or Don't file. If it shows Choose…, pick one. Then select File, or Done if that PDF isn't being filed.
Review the return detail page that opens and hover over its status icon to read the status name.
For a PDF already saved for that client, choose New Return → Existing Document, select the file (open its folder first if needed), and choose Confirm. Planning → Taxes → Overview also provides Upload return and Existing PDF, which open the same workflows.
The Existing Document picker lists every PDF saved for that client: filed PDFs, hidden PDFs, PDFs waiting in the Inbox, and PDFs Kerdora kept without filing. It omits files in archived folders. A PDF with no folder sits at the picker's top level, and choosing a PDF doesn't move it or change who can see it.
Who can see a tax return I upload in Kerdora?
A new tax-return upload on Planning → Taxes → Returns starts as a kept file: not filed, and hidden from clients. A Where these go dialog then asks where it goes. Extraction has already started by then, so this choice only decides where that PDF is kept.
File puts that PDF on the Filed tab of that client's Documents page, still hidden, even inside a visible folder.
Don't file, or closing Where these go, keeps that PDF as a record without filing it. No screen lists kept files, but New Return → Existing Document still offers it.
Clients can't see hidden folders or files. To share a filed return with your client, select its eye icon on that client's Filed tab in Documents, with the tooltip “Hidden from client — click to show”. A return in a hidden folder stays hidden until an advisor shows that folder with its own eye icon. See The Documents Tab: Uploading and Organizing Client Files for filed and kept files.
Which files and limits apply to tax-return import?
Planning → Taxes → Returns accepts 1 PDF per upload, up to 50 MB. This tax-return upload route allows 20 upload requests per user per hour, separate from the ordinary Documents uploader's limits.
Use a readable PDF containing the return pages you want reviewed. A successful upload confirms storage and starts extraction; it doesn't establish that every form or number was read correctly.
If the PDF exceeds the size limit, obtain a smaller readable copy. If the upload limit is reached, wait before submitting another request. For a damaged or unreadable file, get a corrected copy before retrying.
Can Dora start a tax-return import?
Dora can start a Planning → Taxes → Returns import from a tax-return PDF already saved for a client, hidden files and kept files included.
Ask Dora to import that PDF and review the tax return import card it prepares. Select Import on the card to start identification and extraction; return to Planning → Taxes → Returns to review the new return record.
This approval starts extraction only. After extraction completes, review the return and use Create scenario to build a scenario.
File & extract on Documents can also lead to Dora proposals for Profile changes; see Using Upload & Extract for Client Data for that workflow. Check what a proposal changes before approving it.
What do tax-return extraction statuses mean?
On Planning → Taxes → Returns, each return and form shows a colored status icon. Hover over an icon to read its status name. The Tax returns panel on Overview shows return status as text until completion.
PROCESSING: return identification has started.
FORMS IDENTIFIED: Kerdora has identified forms in an uploaded return package.
EXTRACTING FIELDS: supported forms are being processed. An individual form may show PENDING or EXTRACTING.
COMPLETED: processing has settled. Some forms may still have failed, or no supported fields may have been extracted.
FAILED: return identification or an individual form's extraction failed, depending on which status you're reading.
UNSUPPORTED: that form isn't supported for field extraction.
A failed return has a red icon; the return detail page doesn’t show its stored failure reason. Open each relevant form and compare extracted values with the source PDF. A green completion status isn't a verification of tax accuracy or confirmation that every form is usable in a scenario.
Why is my tax-return import stuck at “Waiting for form identification”?
In a return detail page under Planning → Taxes → Returns, “Waiting for form identification” means no identified federal forms are available to display. It doesn't, by itself, prove that processing is still running.
Check the overall return status as well as that message.
Reopen the saved return to check its current state; don't immediately submit another copy.
If the status is FAILED, or COMPLETED with no usable forms, check that the source PDF opens and contains readable federal return pages.
If processing doesn't advance, contact Kerdora Support with the household, filename, approximate upload time, current status, and exact message.
Kerdora doesn't display a guaranteed completion time for this workflow. The waiting message can remain even after a failed import or an import that identified no federal forms. Support should investigate a stalled record rather than treating a fixed number of minutes as proof of success or failure.
How do I review an extracted tax return?
In Planning → Taxes → Returns, open a saved return and inspect each relevant federal form before creating a scenario.
Confirm tax year and taxpayer names in the return header. To identify its source PDF, find the return in the Tax returns panel on Planning → Taxes → Overview, which lists the document name when available.
Select a form in the Forms list and use its displayed page range to locate the matching source pages.
Compare material fields with the original PDF. Read any form-level extraction warnings or errors.
Record missing or incorrect values for correction in a scenario's Inputs after creation.
The extracted-form display is a review surface, not an editor for the source PDF. To preview or download that PDF, open it in Documents. A tax-return upload Kerdora kept without filing isn't listed there, so ask Dora to file it in a named folder first, then select Approve on Dora's proposal.
Identification, extraction, and scenario calculation have different coverage. A recognized form isn't a promise that all its fields feed a calculation. State returns, special worksheets, and unsupported details may require separate review with your client's tax professional.
How do I create a tax scenario from an imported return?
In a return detail page, Create scenario becomes available only when the return is COMPLETED and at least 1 form has extracted fields.
Select Create scenario after reviewing the return.
If Match return names to household opens, check each Destination. Choose the correct existing Client. Add new person is offered only while space remains within the 2-Client limit, counting other new people in this dialog.
If you chose Add new person, check New adult name. If that person already exists as an Other adult, cancel and review Member type in Profile → Household first to avoid a duplicate. Whenever the matching dialog opens, select Create scenario to confirm your choices.
Review the new scenario under Inputs, including its year, filing status, state, income, deductions, credits, and payments.
Open 1040 review to compare supported modeled lines with the source return.
Name matches can skip the matching dialog. When return-person and household-Client counts match, Kerdora can also match by household order even when names differ.
Check each Client's wages and other per-person amounts in Inputs after creation. Add new person creates a household Client while space remains; it isn't confined to the scenario.
Another route is the scenario + (New scenario) menu: select a return under From a tax return, such as Tax return 2025, enter Tax Return Scenario Name, and select Confirm. Only completed returns with extracted fields appear there. The matching dialog can also open after Confirm.
Why can't I select an Other adult or add another person during tax-return import?
Planning → Taxes → Returns matches return names only to household members whose type is Client. Other adults aren't destinations, and Add new person is unavailable when the household already has 2 Clients or other new-person choices use the remaining space.
If a return names an Other adult and this household has room for another Client, that person's Destination can start as Add new person. Selecting Create scenario then adds a second household record for that person, as a Client. Select Cancel instead and review Member type in Profile → Household first.
Confirm who this household's plan is for before changing Member type. Every tax scenario counts only Clients' per-person amounts, including wages and Social Security, business activities, and ages. Saved Other adult inputs are kept but skipped.
Member type also affects retirement timing, insurance needs, and estate questions; see Managing Household Members, Businesses, and Trusts.
Don't match a taxpayer to an unrelated Client just to continue. When Kerdora can't add another Client, it can preselect an unmatched existing Client, so inspect each Destination. After creation, verify names and per-person values in Inputs; a saved scenario isn't proof that matching was correct.
What should I do when an imported tax-return value is missing or wrong?
In Planning → Taxes → Scenarios, correct verified values in the imported scenario's Inputs and compare the revised calculation with its source return.
An imported scenario links to its extracted return and uses supported mapped values, including W-2 Box 1 treatment for imported wages. It doesn't replace Profile income or savings records. Adding a missing Client during name matching is a separate household change.
Imported values can be fixed overrides. Copying an imported scenario into a different year doesn't automatically turn every prior-year amount into a current-year estimate. Review each material input before using that copy as a baseline; see Creating and Comparing Tax Scenarios.
How do I retry a failed tax-return import?
On Planning → Taxes → Returns, check a stalled return's source PDF and status before starting a fresh attempt; retry only after that return has finished or failed. Ask Support to investigate a return that remains in progress.
Choose New Return → Existing Document, select a PDF, and choose Confirm. This picker lists every PDF saved for that household, hidden files and kept files included, and omits files in archived folders. For a corrected file, choose New Return → Upload PDF; a new upload starts hidden from that client, and a Where these go dialog asks where to keep it.
Each attempt creates another return record. It doesn't repair or replace the earlier one, and there’s no control to delete return records. Check the outcome before starting another attempt.
