Skip to main content

Document Settings

Settings → Templates → Documents controls how printed and PDF documents look — invoices, quotes, job cards, purchase orders. This is where logo size, fonts, field visibility, and layout are configured.


What Document Settings Controls​

Settings → Templates → Documents has four tabs — Job, Quote, Invoice, and Purchase Order — one per configurable document type:

DocumentWho sees it
Job (job card)Technicians, customers (sign-off copy), internal records
QuoteCustomers — often the first impression of the business
InvoiceCustomers — the most important document to get right
Purchase OrderSuppliers

Each document type has its own settings panel. Changes take effect on the next document generated (existing PDFs already sent are not changed).

The job card PDF is configured on the Job tab. There is no separate tab called Job Card. Whatever the Job tab is set to show is what prints when someone presses Print on a job. See Job Card Document below for every option on that tab.


Logo Settings​

The company logo is configured in Company Settings. In Document Settings, you control how it appears on each document:

SizePixel height
Smaller80px
Normal100px
Larger120px

Best practice: Use Normal. Small logos can look unprofessional; Large logos take up valuable document space.

After changing logo size, preview a document to confirm the logo is rendering correctly and not overlapping text.


Font Settings​

Font sizes can be adjusted per document type:

Document typeFont options
Job (job card)Smaller (9pt), Normal (10pt), Larger (11pt)
Other documentsSmaller (11pt), Normal (12pt), Larger (13pt)

Use smaller fonts when documents need to fit more line items on a single page. Use larger fonts for accessibility or when documents are printed on larger paper.


Page Orientation​

Documents print in portrait by default. Only the Job tab has an orientation choice, so a job card can be switched to landscape. Quotes, invoices and purchase orders have no orientation setting on this screen.


Field Visibility on Documents​

Each document can show or hide specific sections and fields. This is separate from field settings on records — it controls what appears when the document is generated.

Common field visibility options:

Field/SectionWhat it controls
Bank DetailsShow/hide the payment account information on quotes and invoices
Unit of MeasurementShow/hide UOM column on line items
Inventory CategoryShow/hide item category on line items
DepositsShow paid deposits subtracted from the total
PaymentsShow payment history (partial payments already made)
Totals at the BottomShow subtotal/tax/total summary at page bottom
TermsShow/hide terms text on the document
Custom FieldsShow/hide specific custom fields on the document

Bank Details on Invoices​

Bank details only appear on invoices if both conditions are met:

  1. Bank details are filled in under Settings → Company → Details (account name, number, bank, branch code), or on the store's Bank Settings tab for a Multi-store business
  2. "Show Bank Details" is enabled in Settings → Templates → Documents → Invoice

Quotes have the same Bank Details option under Settings → Templates → Documents → Quote, and it is on by default for both documents. The document prints the bank details of the store the quote or invoice belongs to, so there is one set per store. See Company Settings.

Notes on Quotes and Invoices​

The Notes box on a quote or invoice prints on the PDF below the line items whenever it has text in it. No document setting hides it. Customers who need a second bank account on their documents can type it into the Notes.


Invoice and Quote Document Configuration​

These are the most business-critical documents. Key settings:

Invoice Document​

SettingRecommendation
Bank DetailsON for businesses that collect EFT payments
DepositsON if deposits are taken before final invoicing
PaymentsON for partial-payment situations
TermsON if the business has standard payment terms
Totals at the BottomON — standard practice

Quote Document​

SettingRecommendation
Primary LocationOff by default. Tick it under Customer Details to print the customer's address on the quote; choose Delivery or Postal for the address type.
Show Terms & ConditionsON — protects the business
Validity PeriodShows "This quote is valid for X days" — pulled from Settings → Quotes → Expiry Period
Show Custom FieldsDepends on what's configured and whether it's useful for the customer to see

Job Card Document​

The job card is often used for:

  • Printing a work order for the technician
  • Customer copy for sign-off
  • Workshop intake paperwork

All of this is set up under Settings → Templates → Documents → Job. That tab is where the job card PDF is configured.

Job card styles. A business can keep up to three versions of the job card, for example one for the customer and one as a technician's job sheet. Pick the one to edit in the Document Style Name dropdown, and use the plus icon to add another. Each style has its own Title, and that title is what staff choose from when they press Print on a job. The first style is called "Job Card" by default.

Stylise Document. Each style has these settings at the top:

  • Title, printed on the document.
  • Orientation, portrait or landscape.
  • Logo Size: Smaller, Normal or Larger.
  • Font Size: Smaller (9pt), Normal (10pt) or Larger (11pt).
  • PDF Strict Mode.
  • Available on Customer Zone, which lets the customer print this style from the Customer Zone.
  • Compact View. While it is ticked, Logo Size and Font Size cannot be changed.

Use Preview to download a sample PDF with the current settings before pressing Save.

Select document information. Below that are tick boxes for what appears on the job card, in five groups. A box that is indented only works when the box above it is ticked.

GroupTick boxes
Header DetailsLogo, Barcode, Header is Repeated, Company Details (with Postal Address, Company Registration Number and VAT Number under it)
Customer DetailsCustomer Code, Customer Name, Contact Name, Email, Mobile Number, Address (with Address Name under it)
Customer Custom DetailsOne box for each customer custom field, shown under the name the business gave that field
Job DetailsAssigned employees, Assigned Van, Customer Assets, one box for each job custom field, Accessories, Assessment Fee, Fault Causes, Fault Codes, Fault Reasons, Previous Job Number, Reference Number, Supplier
Additional DetailsMaterials (with Show Type, Show Unit and Display Image under it), Group Materials by (Categories or Sections), Blank Materials Used, Quotes, Invoices, Appointments, Timers (with Billable Column, Overtime Column and SLAtime Column under it), Tasks, Job Summary, Internal Comments, Public Comments, Attached Images, Signatures, Terms, Job Forms, Customer Forms

Show Unit can only be ticked when units of measurement are switched on for inventory. Group Materials by is greyed out unless inventory categories or sections are in use.

A new job card style starts with company details, customer name, contact name, email, mobile number, address, address name, assigned employees, barcode, logo, header repeated on every page, timers with all three timer columns, signatures, and materials with their type ticked.


Size limits​

Printed and emailed documents have a few size limits. Most customers never reach them. A job with a large number of photos is the usual exception.

Photos on the job card​

When Attached Images is ticked on a job card style, the job card shows the photos attached to the job in an Attachments table, one row per photo with its description, the date it was last modified, who last modified it and the picture. Only image files count. PDFs, spreadsheets and other documents attached to the job never appear in this table, and signatures are printed separately under Signatures.

Two limits apply to that table.

  1. Document size limit. Each photo is shrunk to at most 1280 pixels on its longest side and compressed before it goes into the PDF. The job card then allows about 16 MB of photos in total, which is 80% of a 20 MB document limit. The rest is kept for the text and tables. Photos are added oldest first. A photo that would take the total over 16 MB is left out, and a later, smaller photo can still fit after it. Every photo left out this way is counted in the message "X attachment(s) not displayed (document size limit reached)" at the bottom of the table.
  2. Display limit of 200. The table never shows more than the first 200 photos on the job. If a job has more, the job card says "There are a further X attachments not displayed", or, when the size limit was also reached, adds "a further X not displayed (display limit of 200)" to the size message.

The photos left out are still on the job. Only the printed job card leaves them out.

Neither limit is a setting. A business cannot raise them from Settings → Templates → Documents.

Other documents​

The size limit and the 200 photo limit apply only to the job card's attached images. Quotes, invoices and purchase orders only show the stock item pictures turned on with Display Image, and forms print their own images. None of those show the "document size limit reached" message.

Emailing documents​

An email sent from ServCraft can carry about 30 MB of attachments in total, counting the PDF and any files attached to it. When the attachments are larger than that, the email is not sent and fails with an "Email payload too large" error. Email bodies have a separate 500 KB limit, described in Manual Messages and Templates.

Uploading files​


Common Document Issues​

"The invoice looks different from what the customer expects"​

Compare the Settings → Templates → Documents → Invoice configuration against a sample. Usually a field visibility issue (bank details, terms, totals layout).

"The logo is too big / too small on documents"​

Settings → Templates → Documents → [Document Type] → Logo Size. Change and preview.

"Custom fields are showing on documents but we don't want them there"​

Settings → Templates → Documents → [Document Type] → uncheck the custom field visibility.

"The quote terms don't appear"​

Two places to check: (1) Settings → Quotes → Terms & Conditions (is there text?), (2) Settings → Templates → Documents → Quote → Show Terms is enabled.

"The customer's location isn't showing on the quote PDF"​

Go to Settings → Templates → Documents → Quote. Under Select document information → Customer Details, tick Primary Location and choose Delivery or Postal for which address to print. Click Preview to check the output, then Save. The same setting exists on the Invoice tab.

"Bank details appeared on invoices, now they're gone"​

Either the bank details were deleted from Settings → Company, or the "Show Bank Details" toggle was turned off in Settings → Templates → Documents → Invoice.