Account
Branding
Put your logo and colour on your PDFs, pay pages, client portal and emails, choose a template, and remove the \"Powered by\" line on Team.
Your clients should see your business, not ours. Each business has its own logo and colour, which carry through to everything your clients see: the PDF, the pay page, the client portal and the emails you send. On the Team plan, the small "Powered by Free Invoice Automation" line disappears too, so your documents carry only your brand.
Where your brand appears
| Surface | Your logo and colour | "Powered by" line on Free |
|---|---|---|
| PDFs (invoices, estimates, credit notes, receipts) | Yes | Yes |
| Pay page | Yes | Yes |
| Client portal | Yes | Yes |
| Emails to your clients | Yes | Yes |
| Estimate page, pay-me page and verification page | Yes, with a simple business-branded layout |
Client-facing pages use a plain layout themed by your business, with no app menus and no analytics. There are never any ads, affiliate links or sponsors on your PDFs, pay pages, portal or client emails, on any plan.
Your logo
Upload a logo per business.
- Formats: PNG, JPEG or WebP. SVG files are not accepted; export your logo as PNG instead.
- Size: keep the file small; as designed, logos are limited to 2 MB.
- Processing: every upload is re-encoded, resized and stripped of hidden metadata (such as camera or location details) before it is stored. Files are stored privately and served through short-lived links.
Select the business
Use the business switcher at the top of the app.
Open Settings > Branding
You need businesses.manage to change the logo. The Owner and Admin have it by default.
Upload the logo
Choose a PNG, JPEG or WebP file.
Pick your brand colour
The colour themes the client-facing pages of this business, such as the pay page and the portal.
Save
New PDFs, pay pages, portal pages and emails use the new logo and colour. Sent documents keep the snapshot they were sent with, so what your client already received never changes.
Templates
PDFs are drawn from templates, and the same template is used in the browser and on our servers, so a document looks the same everywhere: in the free generator, in the app preview, as a download and as an email attachment.
- Options: a template's layout, colours, fonts, labels, footer and paper size (A4 or Letter) can be adjusted. Choose the template at the level you need: per business, per client or on one document. See Settings for how levels work.
- Variants: every template has a VOID variant with a stamp, and a CREDIT NOTE variant that references the original invoice number, so your clients never pay the wrong thing by mistake.
- Verification QR: every PDF carries a QR code that opens a page where anyone can check the document is genuine. It cannot be removed. See Verification codes.
- Who can edit templates: members with
templates.manage(Owner, Admin and Editor by default).
More about templates on PDFs and templates.
The "Powered by" line
| Free | Team | |
|---|---|---|
| "Powered by Free Invoice Automation" on PDFs, pay pages, portal and emails | Shown | Removed |
| Your logo and colour | Yes | Yes |
| Templates and template options | Yes | Yes |
| Custom domains and full white-label | No | No (Enterprise, after launch) |
On Team, the line is removed as soon as you upgrade, and it stays removed during the grace period if a renewal payment fails.
If a Team account moves back to Free, the line returns on new PDFs, pay pages, portal pages and emails. Documents already sent are not changed. Your branding settings are kept, and when you upgrade again they come back as they were. See Failed renewal and downgrade.
Custom domains and full white-label are planned for the Enterprise plan after launch. On Free and Team, client pages are served from freeinvoiceautomation.com, themed with your business's logo and colour.
Through the API
Branding is part of the business and its settings, so the same calls work from the API, CLI and AI agent.
Upload the logo file
POST /v1/files with the image. You need businesses.manage. The response gives you the file's id.
Set it on the business
PATCH /v1/businesses/{id} with logo_attachment_id set to that id.
curl -X PATCH "https://api.freeinvoiceautomation.com/v1/businesses/0193f2a1-0b0b-7c4e-9a10-2d3e4f5a6b70" \
-H "Authorization: Bearer $FIA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: studio-north-logo" \
-d '{ "logo_attachment_id": "0193f2b2-9d8c-7b6a-8f5e-4d3c2b1a0f9e" }'The business colour and default template are business settings; read and change them with the settings endpoints.
| Capability | Route | Permission |
|---|---|---|
| Upload a file | POST /v1/files | businesses.manage for a logo |
| Update a business | PATCH /v1/businesses/{id} | businesses.manage |
| Get settings | GET /v1/settings | settings.view |
| Update settings | PATCH /v1/settings | settings.manage |
Permissions
| Key | Allows | Default roles |
|---|---|---|
businesses.manage | Upload and change the business logo | Owner, Admin |
settings.manage | Change the business colour and default template | Owner, Admin |
templates.manage | Edit templates | Owner, Admin, Editor |
Errors
| Code | HTTP | When |
|---|---|---|
validation_failed | 422 | The file is not PNG, JPEG or WebP, is too large, or the colour is not a valid hex value. |
permission_denied | 403 | Your role lacks the key for the change. |
business_out_of_scope | 403 | The business is outside your business scope. |
plan_limit_reached | 403 | The account has reached its storage fair-use limit. |