Common issues
This page covers the most frequently encountered problems and their solutions. If your issue is not listed here, see Getting help.
Invoice processing problems
Invoice upload fails
Problem: You try to upload an invoice but receive an error or the upload never completes.
Solutions:
- Check your internet connection is stable.
- Verify the file is a supported format: PDF, PNG, JPEG, GIF or WebP.
- Ensure the file is under 10 MB.
- Try refreshing the page and uploading again.
- If using the Chrome extension, make sure you are signed in and the extension is enabled.
AI extraction returns poor results
Problem: The extracted data is mostly incorrect or fields are missing.
Solutions:
- If you uploaded a photo, check that it is clear, well-lit, and not skewed. Re-photograph and re-upload if needed.
- Use the original PDF from the supplier instead of a scanned or photographed copy whenever possible.
- Check whether the invoice is in a language other than English - Brikly currently supports English-language invoices.
- If the same supplier's invoices consistently extract poorly, contact support so the team can investigate the format.
Items are not matching correctly
Problem: Line items are matched to the wrong ingredients, or matches that should be automatic are not being suggested.
Solutions:
- Check that the ingredient you expect exists in your ingredient list and is spelled consistently.
- Review your matching history for this supplier - inconsistent past matches can confuse the system.
- If an ingredient was recently renamed, previous matches may not carry over automatically. Re-match the item on the next invoice.
- Ensure you do not have duplicate ingredients (e.g. "Chicken Breast" and "Chicken Breast Fillet" for the same product). Merge duplicates if needed.
- "The supplier on this invoice ... is archived" when you create an item from a line: restore that supplier from Suppliers, or change the invoice's supplier, then try again. A supplier that was merged into another can't be restored, so change the invoice's supplier instead.
VAT totals do not reconcile
Problem: The invoice summary warns that the line items don't add up to the invoice total, and the warning points at VAT: the lines look like they already include VAT, or the VAT printed on some lines does not match their rate.
Solutions:
- If the lines look like they already include VAT, Brikly read them as ex VAT. Open each line with Edit, tick Line total includes VAT and save. On an expense invoice, set To pay on each line to the amount printed on the invoice instead. There is no price type setting on the supplier: Brikly works the price type out on every invoice. See Correcting the price type on a line.
- Verify that the extracted unit prices and quantities are correct. A single misread digit throws off the totals.
- If the invoice includes a mix of VAT rates (0% and 20%), check that each line item has the correct rate assigned.
- Small rounding differences don't raise the warning at all (up to 50p, or 1% of the total on a larger invoice). See Checking the totals.
Line items do not add up to the invoice total
Problem: The invoice summary shows a warning that the line items add up to a different amount than the invoice total, for example "Line items add up to £129.52, but the invoice total is £126.57". The first figure is what the bill will post, with VAT added at each line's rate.
Solutions:
- Compare the extracted line items against the original document. The most common causes are a missing line, a misread price or quantity, or a duplicated line.
- If the lines come to less than the total, check whether the difference matches a delivery charge or fee printed on the invoice that was not extracted as a line item, and use Add the missing line.
- If the lines come to more than the total, look for a line that was read twice or a quantity that was read wrongly, and edit or remove it.
- If the warning says the lines look like they already include VAT, tick Line total includes VAT on those lines (on an expense invoice, set To pay to the amount printed). If it says the VAT printed on some lines does not match their rate, check the VAT rate on those lines. Brikly won't send the bill until these two are fixed - see When the difference is the VAT.
- Small differences within a few pence are usually rounding and can be ignored - the warning only appears when the difference is meaningful.
If the invoice has discounts that you have not applied yet (common on supermarket receipts with promotional savings), Brikly shows a blue informational note instead of the warning - the difference simply matches the unapplied discounts. Apply the discounts from the Discounts panel and the totals will reconcile. Pending discounts must be applied or dismissed before the invoice can be sent or marked complete.
"This item is being changed right now"
Problem: Deleting an invoice, or changing its category with Treat as expense or Treat as COGS invoice, says "This item is being changed right now. Please try again in a moment."
Solutions:
- Someone else is editing, archiving or matching an item on that invoice at the same moment. Nothing was changed.
- Wait a moment and try again.
Accounting problems
A bill was not sent
Problem: Submitting an invoice to Xero, QuickBooks or Sage stops with a message, or a bulk send lists invoices that were not sent.
Solutions:
- Read the message: it names what to fix, and most say "so nothing was sent". Fix that, then send again.
- "Map ... to a Xero contact before sending" - choose the supplier's contact on the invoice. See The supplier's contact.
- "... is archived in Xero, so nothing was sent" - the supplier's mapped contact has been archived (or made inactive in QuickBooks or Sage). Restore it in your accounting platform, or select Choose another on the invoice. See The supplier's contact.
- An account code "no longer accepted", a line with "no QuickBooks account", or "We could not read your Xero chart of accounts just now" - see Account codes are checked before sending.
- "This invoice's site sends its bills to ..., which is no longer connected" - choose another company for the site on the Location routing tab under Manage on the connection in Settings > Integrations, or reconnect the company.
- "The Xero authorisation has expired" - reconnect the connection in Settings > Integrations, then send again.
Not sure whether a bill reached Xero
Problem: A send said "Xero didn't answer in time, so the bill may already be there", a bulk send marked an invoice May already be in Xero, or a send is stuck as being sent.
Solutions:
- Look for the bill in Xero first. Brikly won't send that invoice again from the invoice page or a bulk send: it can only be sent again from the Bill submissions tab.
- Open Manage on the connection in Settings > Integrations and go to the Bill submissions tab. If the bill is in Xero, choose I found it in Xero and Brikly marks the invoice as sent. If it isn't, use Retry (or, for a send stuck for more than 10 minutes, Cancel, then send it again).
- If someone changed the bill in Xero after it was sent, Brikly lists Bills in Xero that might be this one, each saying what differs. Choose the right one and Mark as sent with this bill rather than Retry, which would put a second bill in Xero.
- QuickBooks and Sage have no I found it button, so check there yourself first.
- See When the platform may already have the bill.
Login issues
Cannot sign in
Problem: Your email and password are not accepted.
Solutions:
- Double-check that you are entering the correct email address (the one your invitation was sent to).
- Use the Forgot password? link to reset your password.
- Clear your browser's cache and cookies, then try again.
- Check whether your account has been deactivated by your workspace Owner or Admin.
- If you can sign in but see This account is not active, the whole business account is deactivated. See This account is not active.
Invitation link not working
Problem: You received an invite email but the link does not work.
Solutions:
- Invitations expire after 7 days. Ask your Admin or Owner to resend the invitation.
- Make sure you are clicking the link in the original email - do not copy only part of the URL.
- Check that you are not already signed in with a different account. Sign out first, then click the invitation link.
Billing and access
There is an amber banner at the top of every page
Problem: Every page shows "Your last payment didn't go through".
Solutions:
- Stripe could not take the last subscription payment. Everything keeps working for a grace period, so you have time to fix it.
- Owners and admins: click Update payment method in the banner, then Manage Billing in Stripe, and update the card.
- Members and viewers: pass this on to the account owner. The billing portal is not available to your role.
- The banner clears itself once the payment goes through. See Failed payments for the full picture.
I got a payment failed email
Problem: An email titled "Your Brikly payment didn't go through" arrived, sometimes more than once.
Solutions:
- Update the card in Settings > Subscription, or use the pay this invoice directly link in the email to settle the outstanding invoice.
- Stripe retries the card on its own schedule, so one email per failed attempt is normal. If you have already updated the card, ignore anything sent before that.
- If access has already stopped, settling the payment restores it. Nothing is deleted in the meantime.
- Full detail, including how long the grace period lasts, is in Failed payments.
This account is not active
Problem: After signing in you see "This account is not active" instead of your dashboard, or the Team App says "This workplace's Brikly account is not active. Ask your manager."
Solutions:
- The business account has been deactivated, or someone asked for it to be deleted (which deactivates it straight away). Your data is kept, but nobody in the team can use Brikly until it is reactivated: not the web app, the Team App, kiosks or the Claude connector.
- While the account is inactive, SafetyBrik makes no checklists and sends no reminders. Once it is reactivated, it starts again from the current day, week or month, and the days in between have nothing to sign. Records saved on Team App phones and kiosk tablets are held and sent once the account is active again.
- Owners and admins: click Reactivate account on that screen. It also cancels a pending deletion, and the screen says when that deletion is due.
- Members and viewers: ask an owner or admin to sign in and reactivate it.
- You can deactivate or delete the account in Settings > Profile, under Deactivate or delete account (owners and admins only).
We couldn't check your plan just now
Problem: A Brik's page, or Settings > Subscription, says "We couldn't check your plan just now." with Try again.
Solutions:
- Brikly couldn't read your plan for a moment. It is a short problem on our side, not a change to your account, and nothing has been switched off.
- Click Try again in a moment.
- A Brik's page never swaps to the upgrade card, and Settings never asks you to start a plan, while Brikly can't check your plan, so you don't need to do anything in Settings.
- A page you already had open may show an error such as "We couldn't check CostingBrik just now. Try again in a moment." while the check is failing. Nothing about your plan has changed: reload it in a moment.
- If your plan couldn't be read when Brikly opened, the sidebar lists every Brik for now, including any you don't have. It goes back to your own Briks once your plan can be read.
- If it keeps happening, contact support.
We couldn't check SafetyBrik just now
Problem: A SafetyBrik page says "We couldn't check SafetyBrik just now. Try again in a moment."
Solutions:
- Brikly couldn't confirm your business's SafetyBrik for a moment. It is a passing hiccup, not a change to your account, and nothing has been switched off.
- Try again in a moment. On the Team App and the kiosk, anything saved on the device is kept and sent again by itself.
- If a SafetyBrik page briefly asks you to activate SafetyBrik when you already have it, reload the page.
- If it keeps happening, contact support.
Calculation discrepancies
Recipe cost seems wrong
Problem: A recipe's calculated cost does not match what you expect.
Solutions:
- Check the ingredient prices used in the recipe. Go to the recipe and review each ingredient's current unit cost.
- Verify the quantities and units in the recipe are correct (e.g. 0.5 kg vs 500 g - Brikly handles conversions, but the source value needs to be right).
- If you recently processed an invoice, check its lines. Matched lines update ingredient prices as soon as the invoice is processed, without waiting for you to review it, so a misread or test invoice may already have changed the cost. Correct the line, or delete the invoice if it should not be there. A price waits while Brikly still has a question on the line (a pack size, for example), and an invoice older than the price already on file never replaces it.
- Look at the active site - recipe costings are site-specific. Make sure you are viewing the correct site.
Dish margin looks incorrect
Problem: The food cost percentage or margin for a dish seems off.
Solutions:
- Verify the selling price. If you are integrated with Square, check that the latest menu price has synced.
- If the selling price was entered manually, make sure it is the price your customer pays, including VAT, and that the recipe's VAT rate is right. Brikly takes the VAT off before working out the margin, so a price typed without VAT has VAT taken off twice and the margin reads too low.
- Review the sub-recipes - if a dish uses a sub-recipe whose cost has changed, the dish cost updates accordingly.
- Check whether the cost is marked Incomplete. A line Brikly could not price (an ingredient with no supplier price, or a sub-recipe that needs a finished weight) adds nothing to the cost, so the margin looks higher than it really is. See Lines Brikly cannot cost.
- A margin shown as a dash means the recipe has no selling price, or nothing on it is costed yet. A negative margin in red means the dish costs more than its price without VAT. See GP% and selling prices.
Browser compatibility
Recommended browsers
Brikly works best on the latest versions of:
- Google Chrome (recommended - required for the Chrome extension)
- Microsoft Edge
- Mozilla Firefox
- Apple Safari
Internet Explorer is not supported. If you are using IE, please switch to one of the browsers listed above.
Display or layout issues
Problem: The interface looks broken or elements overlap.
Solutions:
- Update your browser to the latest version.
- Clear your browser cache (Ctrl+Shift+Delete on Windows, Cmd+Shift+Delete on Mac).
- Disable browser extensions that might interfere (ad blockers, privacy tools) and check if the issue persists.
- Try a different browser to see if the problem is browser-specific.
Performance tips
If Brikly feels slow, try the following:
- Close unnecessary browser tabs - each tab uses memory and can slow down your browser.
- Use a wired connection if you are on a slow or unstable Wi-Fi network.
- Clear your browser cache - accumulated cached data can sometimes cause sluggishness.
- Check Brikly's status page - if the platform itself is experiencing issues, this will be reported there.
- Reduce the date range on reports - loading very long periods of data takes more time. Narrow the range to what you actually need.
For the smoothest experience, use Google Chrome with a stable internet connection. Chrome is the most thoroughly tested browser for Brikly and is required for the Chrome extension.