Create, switch, and rename Workspaces
Keep separate books in independent xBoox Workspaces and make sure you are working in the correct one.
What a Workspace represents
A Workspace is one isolated bookkeeping space. It may represent a business, professional practice, side business, rental activity, or another separate set of books. It is not required to match one legal company.
Records are not shared, copied, or linked between Workspaces. Categories, transactions, bank rows, tax settings, Working Papers, reports, members, and Audit Log activity are scoped to the selected Workspace.
Create a Workspace
The following creation flow is the current dev Stripe Sandbox preview. It uses test payment methods, not real payments, and does not activate production billing. See Preview plans and Stripe Sandbox billing.
- Open Settings > Workspaces.
- Select Create New Workspace & Pay to open the Portal Plans section directly in a new browser tab; your current xBoox page stays open.
- In the xBoox Portal, choose the offered plan with monthly or annual billing. xBoox returns you to the app and opens the matching Stripe Sandbox payment flow for the new Workspace.
- After verified payment confirmation, xBoox automatically creates the
Workspace with the next temporary name, such as Untitled Workspace 1.
- xBoox opens the Business Profile Wizard. Confirm the Workspace name, business
details and tracking method, tax registration, Industry, and optional Business Activities.
- Review the starting account and category groups, then select **Finish
Workspace Setup**.
- Rename the Workspace later from Settings > Workspaces when you are ready.
In this preview, every new Workspace, including the first one, requires its own verified Sandbox Checkout. There is no free-trial creation path. Cancelled or unconfirmed Checkout creates no Workspace. The purchaser becomes the Workspace Owner.
If you close the browser after payment, you do not lose the paid Workspace. Verified Stripe confirmation creates it on the server, and it appears again after you sign in. Temporary names increase in order for the same user: Untitled Workspace 1, Untitled Workspace 2, and so on.
The temporary name is prefilled in the Wizard. You may keep it and activate the Workspace, or replace it before continuing.
Until Business Profile setup is complete, xBoox hides the bookkeeping navigation and blocks operational Workspace APIs. Wizard answers are saved as a recoverable draft. Closing the browser or choosing another Workspace does not discard the paid Workspace or the last saved step.
Switch Workspaces
- Open the Me menu and select the row showing the current Workspace name, or open Settings > Workspaces.
- On Settings > Workspaces, select Switch Workspace on the Workspace card you want to open.
- Wait for xBoox to reload the Workspace-scoped data. The current Workspace is marked Current and does not show a switch button.
Always confirm the Workspace badge or Dashboard Workspace name before entering or changing financial data.
The Workspace chooser opens over the page you were viewing without changing that page's address. Use the chooser's close button or the browser Back button to close it and return to the same page. When choosing a Workspace after sign-in, before one has been opened, the close button returns you to the xBoox Portal. The chooser lists existing Workspaces; subscription options remain in the Portal and Workspace management.
Rename a Workspace
- Open Settings > Workspaces.
- On the relevant Workspace card, select Rename.
- Enter the new name, then select Save. Select Cancel or press Escape to discard the change.
The Workspace name is limited to 120 characters. Business Profile, tax, fiscal, and activity settings are managed separately.
Check Data Reads
On Settings > Workspaces, select View Usage on a Workspace card to see its rows read today, current daily limit, reset time in your local time, and the displayed increase counter. In the current dev testing override, the Workspace Owner can increase the daily limit repeatedly even if that counter suggests a monthly cap. These counts belong to the whole Workspace, not just your account. The card's Last Workspace Opened time shows when that Workspace was last opened; it is not an account sign-in time. Storage usage is not shown here yet.
For the dev limit and Owner increase rules, see Continue after reaching the daily data limit. When the limit is reached, its notice also shows actual day-by-day reads for the current UTC month.
Multiple browser tabs
One Chrome profile supports one active Workspace at a time. You may open multiple tabs for the same Workspace. Switching Workspace reloads the selecting tab and pauses other tabs that still show the previous Workspace. Those tabs cannot submit further requests; select Open Active Workspace to load the current Workspace, or close the tab. Unsaved entries are not transferred. A request already accepted by the server may have completed in its original Workspace; check its records before retrying.
To work in different Workspaces at the same time, sign in using a separate Chrome profile for each Workspace. Profiles keep browser sessions and site data separate and reduce Workspace mix-ups. Another ordinary tab or window in the same profile does not provide this separation. xBoox currently supports Google Chrome only.
Important rules
- Workspace isolation is enforced by the API, not only by the visible selector.
- A verified, unused payment entitlement automatically creates one Workspace.
- An Accountant sees only Workspaces where an active membership exists.
- Renaming a Workspace does not move, copy, or merge records.
- Never use Workspace switching as a substitute for transferring a transaction between books.
Workspace Setup Choices
The first-run Wizard uses single-choice radio cards for Business Type, Tracking Method, tax registration and Industry. Industry choices appear as General Self-Employed, Real Estate Agent, Financial Advisor, Mortgage Broker and Custom. Optional activities use checkboxes. When Vehicle Expenses is selected, choose one to ten vehicles and name each vehicle (up to 15 characters; unique names with No.01–No.10 defaults). These names and the count are saved with the setup draft and applied to Business Profile only when setup finishes. For Bank Account-Based Tracking, Home Office and Rental Property details are completed in their own working areas after setup. Review shows the selected activities and vehicle names, plus the fiscal year end for corporations. Required-answer and save failures open the shared system dialog; correct the field and retry.
Resume Unfinished Setup
Without an active same-identity tab, ordinary app startup opens an Owner Workspace whose paid setup is unfinished before reopening a previously used active Workspace. Without an active same-identity tab, after explicit Sign In you choose among multiple authorized Workspaces instead; choosing the unfinished Workspace resumes its setup. The last saved setup step is restored. If several owned Workspaces need setup, the most recently opened is selected; a newly confirmed Checkout return takes precedence. Continue and Back save the draft; unsubmitted input on the current step may need re-entry. If you have another accessible Workspace, use Switch Workspace to open it. That manual choice is respected during the current login. With only one Workspace, continue its setup; no switch action is shown. Do not purchase another Workspace to resume an existing paid one.
A response was interrupted
If you use the xBoox Home Screen app on a phone, keep website storage enabled. After an app update, close and reopen xBoox to load the current session protection. A startup error does not by itself mean bookkeeping records were lost; retry once, and report a persistent error instead of repeatedly submitting an earlier save or delete.
One workspace is active per Chrome profile. Workspace requests carry a profile identifier and selection revision; the server rejects stale selections and checks writes in the database transaction. Different Chrome profiles keep these browser sessions separate. Membership permissions still apply independently.
Pausing a tab cannot undo a request already accepted by the server. When a save or delete loses its response, a reminder is retained in that browser profile. Return to the original workspace and inspect the record, History or Audit Log before retrying. The reminder does not mean the operation failed or succeeded, and xBoox does not automatically resubmit it.
Recovering interrupted operations
An interrupted Workspace switch is synchronized with the server when the current tab resumes. Saves and deletes are confirmed only after a complete response arrives. Requests still running in another tab do not trigger an interruption reminder. If Check Unconfirmed Operations appears, choose Open Audit Log and inspect the original records or History before retrying. After checking, choose Mark as Reviewed to dismiss the retained reminders; this does not retry, undo, or change any record. Closing the notice alone keeps the reminders. Receipt recognition and accepted export tasks remain scoped to their original Workspace after a switch; check their status for completion or failure. Return there to check the result; do not submit a duplicate.
When a browser engine cannot report active Web Locks, the notice instead says that a request may still be running in another tab or may have been interrupted. Check those tabs and the result before marking it reviewed.
Background Exports and Operation Review
In Audit Log, select Check Unconfirmed Operations to reopen the review notice. Check the original records first, then choose Mark as Reviewed. This clears only the displayed browser reminders, not financial records. A later interrupted operation can trigger a new notice. Choosing Open Audit Log cancels the action waiting behind that notice; it does not submit or retry it.
The paused tab hides the previous Workspace behind an opaque screen. Closing the notice leaves the tab paused with an Open Active Workspace button. This opens the latest selection, even if another tab has switched again. The tab initiating a switch reloads directly without the other-tab warning.
Reading records and refreshing lists do not open the unconfirmed-operation dialog. Review remains available in Audit Log and before another write. A deletion explicitly rejected by the database is reported as not deleted; an interrupted or unknown response still requires checking before retrying.
The notice keeps operation details in an expandable Operation Details section. Closing it retains the reminders; mark them reviewed only after checking the records.
When another signed-in xBoox tab is active for the same identity, opening xBoox can resume that tab’s Workspace after checking your current Workspace access. A verified Checkout destination or an explicit Workspace-switch reload takes precedence. Without an active same-identity tab, explicit sign-in still asks you to choose among multiple accessible Workspaces. Choose Workspace lists existing Workspaces; use Settings → Workspaces to create and pay for a new one. If Portal cannot confirm your session, choose Continue to xBoox; access still requires authentication.
Event timestamps, including saved, uploaded, audit and expiry times, are displayed in your device/browser local time and marked Local Time. Transaction and statement dates remain the business dates entered. Export download deadlines include the local time of expiry.
Automatic reminders show only unresolved operations related to the current action. Identifiable records, GST/HST periods and imported files are distinguished. Import previews do not trigger reminders. Check Unconfirmed Operations in Audit Log shows all retained reminders.
For invited PRD Sandbox acceptance only, Create New Workspace & Pay opens an in-app plan and billing-period selector, followed by Continue to Sandbox. This avoids the unpublished website. Cancel closes the selector without starting Checkout. Normal DEV Portal entry remains unchanged; real payments and general PRD registration are not enabled.
Invitation-release declarations
When enabled for the PRD invitation release, the Owner must confirm business purpose and authority before opening a new Workspace. Declare the principal business operating region independently of tax settings or travel location; Quebec-principal-business operations are deferred. Acceptance does not grant membership in another Workspace.