Last reviewed: September 2026.
A Surge is a named date range in SurgeTK. Inside it you choose which Value Adds go into each household's packet, pick the households, and build the packets in one batch. This article covers the full flow in Basic View. Calendar Mode is summarized near the end.
Requires the Pro plan to prepare packets. Any plan can create a Surge and set its packet contents. On the Free plan, the Prepare button opens an upgrade prompt instead of the Prepare Packets window. If the prompt cannot open, you see "This is a Pro feature. Please ask an admin to upgrade."
Before you start
Import your households and accounts first. Packets are built from the data in SurgeTK at build time.
Turn on the Value Adds you want in Settings › Value Adds. A new Surge automatically includes every Value Add that is turned on for your firm at the moment you create it.
Buckets and Guardrails are on by default. Beneficiary, Net Worth, Homework (the Meeting Worksheet) and 1099 need the Pro plan to turn on. The Roth Conversion Letter stays off until you turn it on.
Add your logo in Settings › Firm Info. Packets use the Firm Logo and the Firm Branding Color set there.
Create a Surge
Click Surge in the left menu.
Click Create New Surge. If your firm has no Surges yet, the empty list shows a Create surge button instead.
In the New Surge window, enter a Name (up to 60 characters, unique within your firm).
Pick a Start Date and an End Date. The End Date must be after the Start Date, so a one-day Surge is not possible.
Click Create. The message "New surge created" appears and the new Surge is added to the list.
There are no other fields. You do not pick households or Value Adds at this step.
Problem | Message |
Name is empty | "Enter a surge name." |
Start Date is empty | "Select a start date." |
End Date is empty | "Select an end date." |
End Date is the same day as, or before, the Start Date | "End date must be after the start date." |
Another Surge in your firm already has this name | "You can't create a surge with the same name as another one." |
Open a Surge
Click a row in the Surge list. The Choose Your View window offers Basic View and Calendar View. You can also click the Basic or Calendar button in the row's View column. Basic View is the page described in the rest of this article.
The Surge list
Column | What it shows |
Name | The Surge name. |
Date Range | Start Date to End Date. |
Status | Upcoming (before the Start Date), Active, or Past. A Surge shows as Past from the start of its End Date. Status never blocks preparing. |
Prepared | How many active households in your firm have a packet for this Surge, out of all active households in your firm. The count is firm-wide, not limited to your own households. |
View | The Basic and Calendar buttons. |
Three-dot menu ("More actions") | Edit and Delete. |
Use the search box ("Search by name, date, or range...") to find a Surge.
Set the packet contents
Click Packet Contents at the top of Basic View. The Manage Packet Contents window has two panels:
Included Value-Adds: tick the Value Adds to include. The list shows only Value Adds that are turned on for your firm.
Packet order & uploads: drag items by the handle to set the page order. Value Adds and uploaded PDFs can be mixed in any order. Click Add PDF to attach a PDF. Each upload has a trash icon ("Delete").
Some changes save at once and others need Save Changes:
Action | When it saves | Message |
Tick or untick a Value Add | When you click Save Changes | "Packet contents saved." |
Drag to reorder | When you click Save Changes | "Packet contents saved." |
Add PDF | Immediately | "PDF uploaded." |
Delete an upload | Immediately | "PDF deleted." |
Save with no Value Add ticked | Blocked | "Select at least one Value-Add." |
Upload a file that is not a PDF | Blocked | "Only PDF files are allowed." |
If you close the window without clicking Save Changes, your checkbox and order changes are lost. Uploads and deletions have already happened.
About uploaded PDFs
An uploaded PDF goes into every household's packet in this Surge. There are no per-household uploads.
You upload one file at a time. A new upload is added at the end of the order. Drag it to where you want it.
Uploads belong to the Surge. Deleting one removes it from every packet built after that.
Which Value Adds can be in a packet
Buckets, Guardrails, Beneficiary, Net Worth, Homework, 1099 Letter and Roth Conversion Letter.
Each one must be turned on in Settings › Value Adds.
The One Page Plan is a prospecting tool and can never be added to a Surge packet.
If a Value Add is turned off in Settings after it was added to a Surge, the next Prepare removes it from that Surge. Turning it back on in Settings does not add it back. Tick it again in Manage Packet Contents.
How the packet is assembled
Pages follow the Packet Contents order exactly, uploads included.
SurgeTK adds no cover page, divider pages, or packet-wide page numbers. The pages are joined as they are.
Value Add pages carry the Firm Logo and Firm Branding Color from Settings › Firm Info. A missing logo shows the "Missing Firm Logo" warning.
The Households table
The Households tab shows one row per household under the heading Prepare Households.
Column | What it shows |
Household | The household name. Click it to open the household page and fix data. |
Advisor | The household's first lead advisor. |
Meeting | The meeting date and time saved in the household's Meeting Worksheet settings, when one is set. |
Warnings | One icon per warning. Hover over an icon to read it. Warnings never block Prepare. |
Prepared | A green check when the household has a packet for this Surge. |
PDF icon | Opens the household's packet ("Download advisor packet"). |
Which households are listed
All active households in your firm. Archived households are hidden unless you choose Include archived in Filters.
The advisor filter in the top bar applies to this table, including its "Unassigned" option.
If your role limits you to your own households, the advisor filter is locked and the table shows only those households.
Filters and search
Filters opens a menu with Prepared Status (All, Prepared, Not Prepared), Warnings (All, Has Warnings, No Warnings), Household Status (Active, Include archived) and Meeting Date (From, To). Click Apply to use them or Clear all to reset.
The search box ("Search households") matches household names and advisor names.
What the warnings mean
Warning | Icon color | When it appears |
No Accounts | Red | The household has no accounts. |
All accounts closed | Yellow | The household has accounts, but every one is closed. |
Missing Firm Logo | Yellow | Your firm has no logo in Settings. Every household shows this until a logo is added. |
No Advisor Assigned | Yellow | The household has no lead advisor. |
Household is archived | Yellow | The household is archived. Shown only when archived households are included. |
No Systematic Withdrawals | Blue | None of the accounts that Buckets or Guardrails use has a systematic withdrawal. Shown only when the Surge includes Buckets or Guardrails. |
Accounts Missing Asset Allocation | Blue | An account that Buckets uses has no asset allocation (cash, income, annuities and growth are all zero). Shown only when the Surge includes Buckets. |
Warnings are computed from the data before the build. They do not report build problems; those are in the Batch Run Report. There is no warning for missing beneficiaries; the Beneficiary report itself prints "Missing Beneficiaries" where data is missing.
Prepare packets
Requires the Pro plan.
Tick the households you want. The header checkbox selects the current page. To select every page, use Select all N households in the selection bar. A badge next to Prepare shows "N selected".
Click Prepare. The Prepare Packets window opens with the line "Choose how you'd like to generate your Advisor Packets".
Pick Quick PDF in Browser or Prepare & Download Packets (both are explained below).
With 20 or fewer households selected, the window lists them under "Drag to reorder packet sequence." Drag to change the order.
Click the window's Prepare button.
The order you set in the window is the page order of a Quick PDF. For Prepare & Download Packets it only decides which households are built first; it does not set the order of the files inside the ZIP.
With more than 20 households selected, the window shows "You're preparing N households. If you'd like to determine the order of the households, you have to select 20 or less." instead of the list.
Limits and messages
Situation | What happens |
Nothing selected | "Please select at least one household." |
More than 20 households, and the Surge includes two or more Value Adds | Blocked: "You can't prepare more than 20 households at a time when more than one Value-Add is selected." The message also tells you how many are selected and that a single Value Add has no limit. |
Any number of households, and the Surge includes exactly one Value Add | No limit in Basic View. |
Calendar View | Always 20 at most: "You can't prepare more than 20 households at a time." |
Quick PDF in Browser | 20 at most: "You can't preview more than 20 households at a time." |
You already have a build running for this Surge | "A packet build is already in progress for this Surge. Please wait." One build per user per Surge at a time. |
Archived households are in the selection | They are skipped: "N archived households skipped — restore them to include them in a surge." If every selected household is archived: "All selected households are archived. Restore them to build packets." |
The selection includes households you cannot access | They are dropped without a message. The total in the progress popup is smaller than your selection. |
Many Prepare clicks in a short time | At most 6 Prepare requests per minute are accepted. |
Quick PDF in Browser
Builds one combined PDF for all selected households and opens it in a new tab, where you can view, download, or print it.
The card says: "This does not save household snapshots, mark households as "Prepared," or attach individual PDFs." Nothing is saved in SurgeTK, nothing appears in Batch History, and the households are not marked Prepared.
The new tab shows "Building your Quick PDF Packet…" and "This usually takes only a few seconds. Please keep this tab open while we generate your PDF." The PDF then appears in the tab.
The PDF contains each household's Value Adds and the Surge's uploaded PDFs, in Packet Contents order. Its title is the Surge name followed by the date.
Up to 20 households per Quick PDF.
If any Value Add fails to render, the whole Quick PDF fails. After three minutes without a result, the tab shows: "This is taking longer than expected. This may be a larger packet. Please give us a few more moments. If this is taking longer than 2 minutes, please close this tab and try again."
The finished PDF link stays valid for one hour.
Prepare & Download Packets
Builds a separate packet for each selected household on SurgeTK's servers, saves it, marks the household Prepared, and downloads one ZIP file with every packet.
This is the option that records packets in Batch History and on each household page.
How packet generation works
After you click Prepare, SurgeTK records the batch and queues one build job per household on its servers. The build does not run in your browser, and your internet speed does not affect it.
The build queue is shared by every SurgeTK firm and takes turns between firms. A busy period makes your batch wait longer.
Each builder handles one household at a time. Extra builders start when the queue grows.
For each household, the build first refreshes all of the household's Value Adds, then renders each included Value Add, joins the pages with your uploads in Packet Contents order, and saves the packet.
More Value Adds and more uploads per household mean a longer build.
The progress popup
A dimmed overlay covers the page. The popup shows a percentage, "Building advisor packets…" and "Please do not refresh or close your browser."
A moment later a helper appears: "Stand up. Stretch your legs. Grab a coffee — this may take some time." with "Each packet typically takes around 20–30 seconds. Larger households with more value-adds may take a little longer."
The Prepare Packets cards also show "5-10 seconds per household" for Quick PDF and "1-2 minutes per household" for Prepare & Download Packets. Actual times depend on the queue and on the packet contents.
What happens if I refresh or close the page?
The build keeps running on the server in every case. The on-screen warning only protects the automatic download.
If you | What happens |
Refresh the page | The popup picks the progress back up. The ZIP still downloads automatically when the batch finishes. |
Close the tab or go to another page | The packets and the ZIP are still created. There is no automatic download and no completion message. Download the ZIP from Batch History. |
Wait on a page that is not the Surge list, Basic View, or Calendar View | That page does not show the popup and does not start the download. Use Batch History afterwards. |
SurgeTK sends no email and no in-app notification when a batch finishes.
When the batch finishes
The popup shows "Finished Preparing (X/Y) Advisor Packets", the line "The process is finished. Packets should have been downloaded automatically. You can safely refresh the page to see the updated status." and a Refresh page button. The Households table does not update on its own; click Refresh page.
X is the number of households that got a packet. Y is the number of households that were built. Skipped archived households are listed under it.
For Prepare & Download Packets, one ZIP file downloads. It is named after the Surge and holds one PDF per household, named after the household.
If the ZIP cannot be created you see: "The packets were generated, but the download archive could not be created. Open each household to download its packet, or run the Surge again."
A message sums up the result: "Surge completed — all N packets generated successfully.", "Surge completed with some issues. Opening results…", or "Surge completed — all households failed. Opening results…". When there are issues, the Batch Run Report opens on its own.
Prepared does not always mean complete
A Value Add that fails to render is left out of the packet. The packet is still saved and the household still gets the green Prepared check.
If every Value Add fails, the packet is a single page that reads "No Value-Adds were available to render for this household." It still shows as Prepared.
Always check the Batch Run Report after a batch with issues.
Batch History and the Batch Run Report
The Batch History tab lists every batch run in this Surge, by every user in your firm. Columns: Date / Time, Households, Value Adds, Result, Zip, Details. The search box is "Search batch history".
Result badges: "In progress", "All passed", "All failed", or "N of M had issues".
The Zip column downloads that batch's ZIP ("Download ZIP"). It contains only the households in that batch.
The Details column ("View details") opens the Batch Run Report. It counts Households, Passed, Partial, Failed and Skipped, and lists each household as "Passed", "Partial", "Failed", "Skipped" or "Building…". Partial and Failed rows expand to show each Value Add and its error text. A "retried" tag means the Value Add succeeded on a second try.
Where to find a packet later
Place | What happens | Link valid for |
Surge page, Households tab, PDF icon | A new tab shows "Preparing PDF" and then displays the packet in the browser. Error: "Unable to fetch the packet – try again." | 5 minutes from the click |
Surge page, Batch History tab, Zip column | Downloads the batch ZIP. | 5 minutes from the click |
Household page, packets table (columns Surge, Date Range, and a PDF icon "Download packet") | Opens the packet. The table sits below the advisor section on the Household tab. Empty state: "No packets prepared". | 1 hour from when the page loaded. Reload the page if it has been open longer. |
Quick PDF tab | Shows the combined PDF. | 1 hour after the preview finished |
Each household keeps one packet per Surge. A new Prepare replaces it. There is no "Download All" button; use the ZIP in Batch History.
Re-preparing and what each Prepare changes
To rebuild, select the households and click Prepare again. The build always replaces the existing packet.
The old Prepared record is removed before the rebuild starts. If the rebuild fails, the household shows as not prepared and the old packet is no longer linked anywhere in SurgeTK.
Every Prepare & Download Packets build also does the following for each household:
Refreshes all of the household's Value Adds, not only the ones in the packet.
Saves a new snapshot on every Value Add in the packet, labeled with the Surge name. It appears in that Value Add's snapshot list.
If the household has a scheduled or completed meeting in this Surge's Calendar Mode, writes the earliest one's date, time, time zone and type into the household's Meeting Worksheet settings, replacing what was there. Households without a meeting keep their existing settings.
Changing Packet Contents mid-Surge
A packet is a fixed file. Each household's build reads the Surge's Packet Contents at the moment its build starts.
Saved changes apply to every build that starts afterwards, including households in a running batch whose build has not started yet.
To update a packet that already exists, re-prepare that household.
Edit or delete a Surge
Edit: in the Surge list, open the three-dot menu and click Edit, or click the pencil ("Edit Surge") next to the date range in Basic View. The Edit Surge window has Name, Start Date and End Date, and a Save Changes button. Keep the End Date after the Start Date.
Delete: in the Surge list, open the three-dot menu and click Delete. The Delete Surge? window asks "Are you sure you want to permanently delete [Surge name] and all of its packets?" Click Delete. The Surge disappears from the list and its packets disappear from every household page. This cannot be undone.
There is no Duplicate option. Create a new Surge and set its Packet Contents again.
Calendar Mode in brief
Calendar Mode shows the same Surge as a calendar of meetings. Open it with Calendar View from the Surge list or the Calendar Mode button in Basic View.
Click Add Meeting to add a meeting for a household: Start, End, Meeting type (Review, Intro, Check-in, Virtual, In-person, Other), Location and Notes.
Two rules apply: "Meetings cannot span multiple days." and "Meeting must fall within this Surge date range."
Use Multi-Select (calendar view) or Select all (list view) to pick meetings, then click Prepare (N) Packets. A single meeting's details panel has a Prepare Packet button. The same Prepare Packets window opens, and the limit is always 20 households.
A meeting must be linked to a household before it can be selected: "This meeting must be linked to a household before it can be selected for packet preparation."
Meetings can be pulled in from Calendly. See Calendly: Sync Meetings Into a Surge.
Who can do what
Role | View Surges | Create, edit, delete and prepare |
Admin | Yes | Yes |
Lead Advisor | Yes | Yes |
Assistant | Yes | Yes |
Team Member with View/Edit | Yes | Yes |
Team Member with View Only | Yes | No |
Preparing packets also requires the Pro plan. Users whose role limits them to their own households see only those households in a Surge. See Roles, seats, and permissions and Plans, billing, and cancellation.
Troubleshooting
Why is my batch slow?
The build queue is shared with every other SurgeTK firm, and each builder handles one household at a time.
Every Value Add and upload adds render time, and all of the household's Value Adds are refreshed before the packet is built.
Your internet speed is not a factor. You can leave the page and come back later; the batch keeps running.
"A packet build is already in progress for this Surge. Please wait."
You can run one build at a time per Surge. Wait for the running batch to finish. If a batch was interrupted, the lock clears on its own after 15 minutes.
Some selected households were not built
Archived households are skipped, with the message "N archived households skipped — restore them to include them in a surge." Restore them from the Households page first. See Archiving households and closing accounts.
Households you do not have access to are dropped without a message.
The ZIP did not download
The download starts only on the page that watched the build. If you closed the tab, download the ZIP from Batch History.
If the popup says the download archive could not be created, open each household's packet from the Households tab, or run the batch again.
A household is Prepared but a Value Add is missing from the packet
That Value Add failed to render. Open Batch History › Details to read the error, fix the household data, and re-prepare the household. For data problems, see Why a Client or Account Is Missing From a Report.
A Value Add is missing from Manage Packet Contents
It is turned off in Settings › Value Adds. Beneficiary, Net Worth, Homework and 1099 also need the Pro plan to turn on. If it was turned off after this Surge included it, the next Prepare removed it; tick it again after turning it back on.
Packets have no logo or the wrong color
Set the Firm Logo and Firm Branding Color in Settings › Firm Info, then re-prepare. Until a logo is set, every household shows the "Missing Firm Logo" warning.
The table still says Not Prepared after the batch finished
Click Refresh page in the popup, or reload the page. The table does not update live.
Prepare opens an upgrade prompt
Preparing packets requires the Pro plan. Ask an Admin to upgrade in Settings › Billing.
