Custom PDF Documents

customising invoice, delivery note & credit note pdf templates breww allows you to customise your pdf documents to get them on brand invoice details simple customisations can be done via our invoicing details tool this allows you to define information, such as how you'd like your company name & address displayed, your bank details, logo, and which document template to use (breww provides a couple out of the box) breww is also powerful enough to allow you to vary these details by customer or customer group this is really helpful if, for example, you sell under multiple brands or would like to show different bank details to a subset of customers there's no limit on how many different sets of invoice details, you'd like to define and of course, there's always a default to apply to any customer that's not had a specific one set this can be managed in settings > order/invoice settings > invoicing details custom pdf document templates breww even allows you to take this to the next level, with fully customisable pdf document templates, meaning you don't need to pick one of our pre built templates if you'd like something entirely different the sky is the limit on the customisations available here ⚠️ we highly recommend not using custom templates unless you absolutely must if you make a custom template, you will not get the new template updates provided by breww and may miss out on new features you also may need to keep your template up to date with important legal changes manually (e g excise duty display requirement changes) if you do make a custom template, please be careful, as you can cause problems rendering documents if you use invalid code here's a short video showing the power available to you when creating your own templates https //youtu be/9dh c2fajpm customising your own invoice & other document templates is considered an advanced feature that will require you to have an understanding of html and css if you wish to make significant changes familiarity with "curly braces template languages", such as twig, jinja or shopify's liquid would be helpful too it is possible for you to make changes to your template which completely break the rendering of your invoices, credit notes & delivery notes, so please be careful and make sure to test your changes before saving them you can customise your templates by visiting settings > order/invoice settings > pdf document templates we allow you to define your own html based header, body and footer, along with styling (css) and 3 custom image uploads you can use this to do anything from minor tweaks to layout and colours, or start fresh and build something entirely different from the ground up your header and footer will be shown on all pages of a document (if it's long enough to need more than one page), with the body being displayed just once your document template will be rendered into a pdf and the same template is used for your invoices, credit notes & delivery notes this means you need to consider all three documents when making a change breww provides many "variables" to you which will be substituted in your template for the relevant value for the document in question for example, you might like to show a heading at the top of your document that shows the invoice number, for example invoice #123 if you were to write the code for this as \<h1>invoice #123\</h1> then you'll find that all documents, show the same invoice number (123), even though this isn't always going to be the case to resolve this, you can change your code to the following \<h1>invoice #{{ document number }}\</h1> this will cause the {{ document number }} part to be substituted for the relevant document number however, this is also not quite right as not all documents are invoices, they may be a sales order, or proforma invoice (if not invoiced yet), or even a credit note, or a delivery note for this reason, we'd recommend using the following \<h1>{{ document title }} #{{ document number }}\</h1> if you're making other changes based on the type of document, you can use our handy document type variables, to show and hide complete sections of code based upon the document type, for example, to only show payment bank details on your invoices the variables you can use for this are is invoice this will be true for invoices and sales orders, but not for other documents is credit note only true for credit notes is delivery note only true for delivery notes for example, you could use the following code hey there, this is your {% if is invoice %} invoice/sales order, please pay us soon {% elif is credit note %} credit note, sorry for the problem {% elif is delivery note %} delivery note, we hope you enjoy the beer {% endif %} a full list of all available variables and their values can be found and tested in the document template management tool in breww the breww team can offer paid support for customising document templates, or you can ask your web developer for help as they should be familiar with the technologies involved sadly, due to the complexity of this, breww's standard support offering doesn't include customising document templates for you, however, we can quote on a case by case basis to customise for you please get in touch via a support ticket, with as much detail as possible, if you'd like us to quote happy customising 🎨 frequently asked questions my new logo, or other invoice details, are not showing, why? if you make changes to your invoice template or invoicing details (e g logo, bank details, etc), these will be used on all future invoices (including orders that have already been inputted but haven't been invoiced yet) when an order is invoiced, all data required to produce that pdf on demand is saved against the order, this means that the logo, bank details, company legal names, template, etc at the time will always be used, even if you try to view that invoice again in many years time and by then have changed the template, logo, etc significantly if you use the invoice template change tester tool, this will let you enter an order/invoice number to view your template changes, however, all details other than the template itself will be as per that invoice this is fairly obvious for things like the customer's name and the product lines, but it also applies to things like the logo that is applied to the invoice if you upload a brand new logo but then test a template against an invoice that was previously raised with an older logo, this will be shown with the logo that applies to that invoice, not the new one if you enter the order number for a non invoiced order, this will be tested with "live invoice details", so you should see the recently uploaded logo on the latest template version how do i give a developer/web designer access to edit my templates? head to settings > users & security settings > invite a new user a permissions group is needed when inviting a new user, so add them to the "settings" group once they've accepted the invite, you can then reduce the permission to just "manage pdf document templates" the developer can then edit the templates can i use custom fonts? you can import fonts from google fonts https //fonts google com/ in your templates breww only supports only google provided fonts, fonts from other sources will be rejected to use this, add an import line to the top of the styling (css) tab (this example is using the silkscreen https //fonts google com/specimen/silkscreen?query=silkscreen font) @import url('https //fonts googleapis com/css2?family=silkscreen\ wght\@400\&display=swap'); then you can reference the font in the applicable places in the rest of the css, using the font family attribute, such as body { font size 16px; line height 1 5; font family 'silkscreen'; }