How Mercerly is organized
Everything in Mercerly hangs off three things: clients, their projects, and the tasks inside each project.
- Clients are the people and businesses you work for.
- Projects are the jobs you do for a client: a website, a brochure, a month of maintenance. Each project gets its own number.
- Tasks are the pieces of a project. You time your work on tasks, and each task is billed by the hour, as a flat fee, or per unit.
From there, the work flows one way:
- Quote it. Send a quote the client can sign. When they accept, Mercerly turns it into a project with its tasks already in place.
- Do it. Start a timer on a task while you work. Log any time you forgot to time, and add expenses you bought for the job.
- Bill it. New Invoice gathers everything that hasn't been billed yet. You tick what goes on the invoice, check the PDF, and create it.
- Get paid. Log payments as they arrive, mark the invoice Paid, and watch the Dashboard and reports add it all up.
Getting started
A few minutes of setup makes every invoice and quote look like yours from the first one.
Install and open Mercerly
Mercerly runs on any Mac with macOS 26.5 or later. Download it, drag it to your Applications folder, and open it.
Add your business details
These print on every invoice, quote, agreement and report.
- Choose Mercerly › Settings (⌘,) and click Business.
- Under Letterhead, fill in your Business Name, address, Email, Phone and Website.
- Under Logo, click Choose Logo… and pick a PDF, PNG or JPEG. Empty space around it is trimmed for you.
- Under PDF Colours, enter your brand colours (a code like #0E4E66, or click the swatch). Leave them blank for neutral grey.
- Write your Invoice Footer (for example, how to pay you) and Quote Footer.
- Under Quote Signer, add the name and title of the person who signs quotes for the business.
- Click Save. New PDFs use the details right away.
Set your defaults
- Settings › General: your Default Hourly Rate. New hourly tasks and quotes start with it, and you can always change it per task.
- Settings › Quotes: the standard terms printed on new quotes.
- Settings › Email: the wording of the emails that carry your invoices, quotes and agreements.
- Settings › Appearance: light or dark, and the text size (also ⌘+, ⌘− and ⌘0).
Your first ten minutes
- Add a client: + New › New Client… (⌥⌘N).
- Add a project for them: New Project (⇧⌘N).
- Add a task: New Task (⌘N), billed hourly at your rate.
- Press Space to start the timer. Do a little work. Click Stop.
- Click New Invoice, tick the task, and click Review Invoice… to see your first invoice as a PDF. Click Cancel if you were only trying it out: nothing is saved until you click Create Invoice.
The main window
One window holds your clients, their projects and the tasks you time.
The three lists
- Clients, on the left. The line under the search box (for example Active with unfinished projects ▾) chooses which clients show: all, active, active with unfinished projects, or not active. The selected client shows its unbilled total; point at any other client to see theirs.
- Projects, at the top right, for the selected client. Switch between All, Active and Inactive above the list.
- Tasks, below, for the selected project. This is where you start timers.
Drag the divider between Projects and Tasks to give either one more room. It stays where you put it.
The tabs
In the middle of each client's header are three tabs: Projects, Invoices and Quotes. When you switch to another client, you stay on the same tab, which is handy for checking invoices client after client.
The top bar
- + New adds a New Client, New Project (for the selected client) or New Task (for the selected project).
- New Invoice starts an invoice for the selected client. If a project is selected, its work is already ticked.
- The timer, in the middle, shows what's running with Pause and Stop. Click the task's name or time to jump straight to it.
- On the right: the selected client and how many active projects they have, and a small cloud that shows whether you're connected.
The Dashboard
When no client is selected, the main window shows the Dashboard. Click the chart button at the top of the client list to get back to it. Each client has its own dashboard too: click the selected client's amount (with the chart symbol), or right-click the client and choose Dashboard.
Getting around with the keyboard
- ↑ and ↓ move through a list.
- → or Tab jumps from Clients to Projects to Tasks; ← or ⇧Tab goes back.
- Return opens the selected client, project or task, the same as double-clicking it.
- Space starts or pauses the selected task's timer.
Choosing columns
Click the Columns button (the small table icon) above the Projects or Tasks list, or right-click a column heading, and tick the columns you want. Show All Columns brings them all back. Each Mac remembers its own choice.
Clients
A client holds everything you do for them: projects, invoices, quotes and payments.
Add a client
- Choose + New › New Client…, click New Client on the Dashboard, or press ⌥⌘N.
- Fill in the name, the person to address (Attention), address, email, phone numbers, website and tax number. Only the name is required.
- Click Save. The new client is selected, ready for its first project.
See and change a client
- See their details: select the client and click the ⓘ button, double-click them, or press Return.
- Edit: right-click the client and choose Edit Client…. Edit Client also has a Country field.
- Finished working with someone? Untick Active. Their history stays, and they drop out of the active list.
- Delete: right-click and choose Delete Client…. Mercerly tells you how many projects and tasks go with them first. A client with invoiced work can't be deleted, so your billing record is always kept.
Projects
Each project is one job for one client, with its own number, notes, tasks and totals.
Add a project
- Select the client, then click New Project (or press ⇧⌘N).
- Give it a name. Project names are unique for each client.
- Optional: pick a Template so the usual tasks are already in place, and add Notes (they print under the project's name on invoices).
- Optional: set a Deposit or Discount (see Deposits and discounts).
- Click Save. Mercerly gives the project the next number.
Change a project
- Double-click it, press Return, or point at it and click the pencil.
- Edit Project shows the Total Time Logged, Total Billable and what's Not Yet Invoiced, and lets you change the name, Start Date, notes and Active.
- Finished? Untick Active so it drops out of the Active list.
- Save as a template: right-click the project and choose Save as Template… to reuse its tasks on future projects. Manage templates in Settings › Templates.
- Delete: the trash button or right-click › Delete. A project with invoiced work can't be deleted.
Reading the list
- Time is all the time logged on the project.
- Unbilled is what's waiting to be invoiced, Billed is what's already been invoiced, and Total is the two together. Expenses aren't included in these amounts.
- Old unbilled work stands out: an Unbilled amount turns orange after 30 days and red after 90. Point at it to see how many days.
- A dot beside a project's time means a timer is running on one of its tasks.
Tasks
Tasks are the pieces of a project: what you time, and what goes on the invoice.
Add a task
- Select the project, then click New Task (or press ⌘N).
- Name it, and choose a Billing Type:
- Hourly: time logged × the hourly rate.
- Flat Fee: one price, however long it takes. Time logged on it is covered by the price.
- Per Unit: a quantity and a price per unit, such as 4 × $5.00 = $20.00.
- Optional: an Estimate (hours), Notes (they print under the line on the invoice), and for an hourly task, Add Time Already Worked with a Start and Stop.
- Leave Billable on for work you charge for. Turn it off for internal time you only want to track.
Reading the list
- Time, Unbilled, Billed and Total work like the Projects list. Invoiced shows which invoice a task was billed on.
- The bar at the bottom adds up the project's tasks.
Right-click a task
- Duplicate Task makes a copy with the same billing, price, notes and estimate, but no time.
- Move to Project… moves a task and all its time to another project, for this client or another. A task that's on an invoice can't be moved (duplicate it instead).
- Delete asks first. A task with invoiced time can't be deleted, so the invoice always matches.
Tracking time
Start a timer when you start working. Mercerly keeps it visible everywhere, so it's hard to forget.
Start, pause and stop
- Start: click the round play button at the start of a task's row, or select the task and press Space. Starting another task stops the first one.
- Pause: click pause, or press Space again. Resume picks the clock up where it left off.
- Stop: click the stop button, on the task or in the timer at the top. Stop is always a click, so a stray key press can't end your session.
While a timer runs, its task is highlighted and the timer shows at the top of the window, in the menu bar, and on the Dock icon. A paused timer flashes on the Dock so it's easy to spot.
Away from your Mac?
If you walk away while a timer runs, Mercerly asks about that time when you come back: keep it, remove it and keep timing, or remove it and stop. It can also remind you when a timer has been running for a few hours. Set both in Settings › Timer.
Add time you didn't time
- Open the task (double-click it, or press Return).
- Under Log Time, pick the Start and Stop, and add a note if you like. Notes print under the task on the invoice.
- Leave Bill This Time on unless this stretch shouldn't be charged.
- Click Log Time.
Timer History
Edit Task lists every time entry: when, how long, who logged it, and any notes.
- Change an entry: click its pencil to change the Start and Stop, whether it's Billable, and its Notes.
- Move an entry to another task: in the same window, pick a Project and Task, then Save.
- Billed time is locked. Its pencil is greyed out and it shows its invoice number. To change it, remove its line from the invoice first.
Expenses
Record what you bought for a job, and bill it back with a markup if you like.
- Select the project and click New Expense above its tasks.
- Enter the Date, Description, Cost and any Markup (%).
- Leave Bill to client on to have it offered on the next invoice. Notes are for you and don't print.
Billable expenses appear in New Invoice with the project's work and go on the invoice as their own lines.
Creating invoices
You choose exactly what goes on each invoice, and you see the PDF before anything is created.
- Select the client (and a project, to start with its work ticked) and click New Invoice.
- New Invoice lists all of the client's unbilled work, grouped by project, newest first. Click a project's name to open it, or Expand All.
- Tick the tasks and expenses to bill. The box beside a project ticks all its work; the box at the top ticks everything. A folded project says what's ticked in it, such as "2 tasks selected".
- Choose Round Time: exact minutes, or round each hourly line up to the next 15 minutes, 30 minutes or hour. Each task shows what it will bill ("6h 3m logged · bills 6h 15m"). Your logged time doesn't change.
- Add a Tax Rate if you charge tax. Leave it blank for none.
- Click Review Invoice…. The invoice opens as a PDF marked Draft Invoice, exactly as it will be made.
- Click Create Invoice to make it, or Cancel to go back and change what's ticked. Nothing is saved, and no number is used, until you click Create Invoice.
What keeps it right
- Nothing is ticked at the start, so nothing ends up on an invoice by accident.
- If a timer is running on a ticked task, Mercerly asks you to stop it first, so the invoice includes every minute.
- If you change what's ticked after reviewing, Create Invoice stops and asks you to review again. The invoice you create is always the one you looked at.
- Only new time is billed. A task invoiced before can keep collecting time; only the unbilled time goes on the next invoice.
- Invoice numbers are given out automatically, in order.
On the PDF
Each project starts with its number and name, then its notes, then its lines (with any Log Time notes under them) and its own subtotal. Projects are in number order and the Total follows the last one. Your letterhead, logo, colours and footer come from Settings › Business.
Managing invoices
Every invoice lives on its client's Invoices tab. Right-click one for everything you can do with it.
The Invoices tab
- Switch between All, Paid and Unpaid, or type in the filter box to find invoices by number, reference, project or any line.
- The line under the list shows how many invoices are showing and their Total (and what's Unpaid, under All). Cancelled invoices aren't counted.
- Double-click an invoice (or press Return) to open it.
- Right-click for Open Invoice, Edit Invoice…, View PDF, Cancel Invoice… and Delete Invoice….
The invoice window
- Set or clear the Due Date, add Notes (they print on the PDF), and log payments.
- View PDF shows the invoice, including changes you haven't saved yet. Click Save PDF… to save the file, or Close.
- Email… opens a new email with the PDF attached (see Emailing).
- Remove a line by ticking it (or clicking its trash). What it billed becomes billable again.
Edit an invoice
Any invoice that isn't marked Paid or cancelled can be edited. Click Edit Invoice… in the invoice window, or right-click it in the list.
- Change a line's name, quantity or price. Remove lines (what they billed becomes billable again, and Put Back undoes it until you save).
- Change the invoice date, due date and tax rate.
- New Item… adds a new task to the invoice's project, already billed. An hourly item also logs its hours on that task. It works on an invoice for one project.
- Add Project Items… adds more of the client's unbilled work, from any of their projects.
- Discount / Deposit… adds a project's discount or deposit.
- Nothing changes until you click Save, which shows what will change and the new total first. Everything is saved together, or nothing is.
Cancel or delete an invoice
- Cancel Invoice… keeps the invoice and its number, marked Cancelled, and makes its work billable again. Restore Invoice… undoes it. Use this for anything the client may have seen.
- Delete Invoice… removes an invoice completely, such as one made by mistake. Its work becomes billable again. If it was the newest invoice, the next one reuses its number; otherwise its number is skipped. An invoice marked Paid, or with payments logged, can't be deleted.
Deposits and discounts
Set them once on the project. Mercerly takes them off the right invoices, under the project's work.
Deposits
A deposit is money the client paid up front. In New Project or Edit Project, under Deposit and Discount, enter the amount and choose when it comes off:
- Next invoice only: for a job billed in parts, such as a deposit up front and the rest on delivery.
- Every invoice: for a maintenance agreement, where the monthly fee is paid ahead and comes off each month's invoice. Only the work beyond it is left to pay.
New Invoice ticks Take off deposit under the project for you; untick it to leave it off this time. It prints as "Less deposit received" and never takes a project below $0. A "next invoice only" deposit is offered until it's been used once: Edit Project shows which invoice it went on, with Take Off Again on the Next Invoice.
Discounts
Choose Percent or Dollars and enter the amount. A discount comes off the project's tasks, not its expenses.
You decide which invoice gets it: New Invoice offers Apply discount under the project, unticked. Tick it on the invoice where it should come off.
Payments and overdue invoices
Log money as it arrives. Marking an invoice Paid is always your call.
- Open the invoice and click Log Payment.
- Enter the Amount, the Date, and a Reference (a check number, or how it was paid).
- The invoice shows Total Paid and the Balance Due.
- When it's settled, tick Paid and pick the Paid Date.
Overdue Invoices
Overdue Invoices (⌘5) lists everything unpaid across all clients, with what's past due at the top. You can email a reminder from there.
Recurring invoices
For retainers, maintenance and hosting: set it up once, and Mercerly reminds you each time one is due.
- Open Recurring Invoices (⌘6, or Recurring on a client's Invoices tab) and click to add one.
- Choose the Client, give it a Name, and add its lines (Description and Amount).
- Choose how often it Repeats (weekly, monthly, quarterly or yearly), the Next Invoice Date, and the days until it's due.
- Optional: a tax rate, and Stop After a Date.
- Click Save.
When some are due, Mercerly opens the list so you can create them with one click. Right-click a schedule to Stop it (it makes nothing until you Restart it) or Delete… it. Neither touches invoices already made.
Quotes
Quotes are built from sections, print as polished PDFs your client can sign, and turn into projects when accepted.
Start a quote
- Open the client's Quotes tab and click New Quote. Quotes are numbered Q-1001 onward.
- Give it a title. The Contact is filled in from the client and can be changed. The quote has its own hourly rate and signer, starting from your settings.
- Add sections yourself, or click Use Template to start from a saved set.
Sections
Each section has a heading, text and prices. Choose what kind it is:
- Included: the work being quoted. Its prices count in the total.
- Extra: offered for the client to choose, such as training. Not in the total.
- Outside Cost: paid to someone else, such as a printer. For information.
- Price List: prices for later work. For information.
- Heading: a title between sections, such as "Phase 1".
New page starts a section at the top of a new page in the PDF.
Prices
- A flat price, a range, per hour, per item (with a quantity), monthly, quarterly, yearly, or "to be provided". Add a note after a price, such as "plus image costs".
- Internal hrs are your own estimate. They never print.
- Pick one: when a section has two or more prices, tick Pick one to make them choices. The quote shows a total for each, and the client ticks the one they want.
Writing the text
- Select text and use the buttons above the box for bold, italic, bullets, numbered lists and indenting. The preview underneath shows how it prints.
- Fill-ins: type a name in braces, like {start date}. Each one gets a field under the Agreement, and a sentence whose fill-in is left blank isn't printed. {hourly rate}, {client}, {contact} and {business} fill themselves in.
- The Agreement box prints at the end, above the signatures. Insert Agreement adds one from the Quote Library.
Preview, send and track
- Save + Preview PDF saves the quote and shows the PDF. The quote stays open so you can fix anything, and the preview updates each time you save.
- The PDF has fields to sign and date, for your client and for you, and boxes for the client to tick their choices and extras.
- Right-click a quote in the list to Email Quote…, Preview PDF…, Duplicate it, or Mark As Draft, Sent, Accepted or Declined.
Accept a quote and start the work
Accept + Create Project… turns an accepted quote into a project with tasks, ready to time:
- Each price in an Included section becomes a task: flat prices as flat-fee tasks, hourly prices as hourly tasks. Internal hours become the task's estimate.
- For a Pick one section, choose what the client picked. For Extras, tick the ones they chose.
- Outside costs you'll rebill become billable expenses on the project.
- Monthly, quarterly and yearly fees open a recurring invoice, filled in and ready for you to save.
- For a price range, choose the high or low end.
Agreements
For ongoing work, like a website maintenance agreement. Built just like a quote, numbered A-1001 onward.
- On a client's Quotes tab, click the arrow on New Quote and choose New Agreement. The menu at the top left shows quotes, agreements, or both.
- Use Template offers agreement templates.
- Monthly, quarterly and yearly fees print with their section. The PDF has no Total unless something one-time is included.
- Accepting an agreement (right-click › Accept…) lists its fees. Pick one and click Accept + Fill In Recurring Invoice…: a recurring invoice opens, filled in with the client, fee and schedule. Mercerly never sets one up without you clicking Save.
- Agreements have their own email wording in Settings › Email.
Quote Library and templates
Write your best sections once, and build every quote from them.
- Open it with Window › Quote Library, or the books button on a client's Quotes tab. It's shared with your team.
- Sections are reusable sections and agreements, each tagged Web, Print or Both. A section can carry starting values for its fill-ins.
- Templates are a name, a type, an agreement, and sections in order. In a quote, Use Template fills them in.
- In a quote, Add from Library… adds copies of saved sections, and the books button on a section saves a copy of it to the library.
- A quote always gets its own copy, so changing the library later never changes a quote already made.
Project templates
Separate from quotes: a project template is a set of tasks for jobs you do often. Right-click a project › Save as Template…, then pick it when you make a new project. Manage them in Settings › Templates.
Emailing invoices and quotes
- With Apple Mail, Mercerly opens a new email to the client with the PDF already attached.
- With other mail apps, Mercerly opens a prefilled email and shows the PDF in Finder, so you can drag it in.
- The invoice remembers the date it was emailed.
- Change the wording in Settings › Email. Leave a box blank to use the built-in wording. Placeholders like the invoice number and amount fill themselves in, and a sentence whose placeholder is empty is left out.
Search and filters
Search everything
The search box at the top of the client list finds clients, projects, tasks, invoices (by number or reference) and quotes and agreements (by number or title), best matches first. Click a result to jump straight to it.
- A project or task opens on its own; click Show All Projects to see the whole list with it still selected.
- An invoice opens the client's Invoices tab and the invoice. A quote opens the Quotes tab with it selected.
- Show All Matches for "…", at the bottom of the results, opens a window with every match for every client, in Projects, Invoices and Quotes tabs. The Found In column says where each match was found. Double-click a row to show it.
- "#5748" and "5748" find the same things.
Filter within a client
Type in the Filter box above the Projects, Invoices or Quotes list (or press ⌘F). It shows everything on that tab that mentions your words, including task names, invoice lines and quote wording, with totals.
The filter stays as you switch clients, so you can check client after client for the same thing. The box is tinted while it's on. Press Esc in the box, click its ✕, or press ⌥⌘F to clear all three.
Dashboard and reports
The Dashboard
A quick read on the business: Ready to Invoice, Unpaid (and how much is overdue), Hours This Month, Billed This Month, Received This Month and Billed This Year, each compared with last month. It's in the main window when no client is selected, and in its own window with ⇧⌘D.
Reports
Everything is in the Reports menu. Each report opens in its own window: set the filters on the left, then click Update.
| Report | What it shows |
|---|---|
| Projects ⌘1 | Projects with their time, billed and unbilled amounts. |
| Time ⌘2 | Where the hours went, by client, project or person, with a chart. |
| Tasks ⌘3 | Tasks with their time and amounts, billed or not. |
| Sales ⌘4 | What you invoiced and what's been paid. |
| Real Hourly Rate ⌘7 | What you actually earned per hour, by project or by kind of work. |
| Quotes ⌘8 | Your win rate, and what you quoted compared with what you billed. |
| Year-End Export ⌘9 | Income by client, payments and invoices for a year, as a PDF or spreadsheet (CSV), ready for your accountant. |
Every PDF is previewed first: click Preview PDF…, check it, then Save PDF….
Working as a team
Everyone works from the same clients, projects and invoices.
- Timer History shows who logged each entry, and the Time report can be filtered by person.
- If someone else changed the same thing after you opened it, Mercerly asks before saving: Keep Their Changes, Save Mine Anyway, or Keep Editing. Nobody's work is quietly overwritten.
- Press ⌘R (View › Refresh) to load the latest changes from everyone.
- Settings marked "This Mac only" apply to your Mac. The rest are shared with the team.
Settings
Open Mercerly › Settings (⌘,).
| Tab | What's there |
|---|---|
| General | Default hourly rate (shared), and which client filter to start with (this Mac). |
| Appearance | Light or dark, and text size (this Mac). |
| Timer | Show the timer on the Dock icon, flash it when paused, remind you when a timer runs long, and when to ask about time while you were away (this Mac). |
| Quotes | The standard terms on new quotes. |
| Templates | Your project templates: rename or delete them. |
| Business | Letterhead, logo, PDF colours, invoice and quote footers, and the quote signer. |
| The wording of invoice, quote and agreement emails. |
Keyboard shortcuts
The full list is also in the app, under Help › Keyboard Shortcuts.
| Keys | What it does |
|---|---|
| ⌘N | New Task, in the selected project |
| ⇧⌘N | New Project, for the selected client |
| ⌥⌘N | New Client |
| Space | Start, resume or pause the selected task's timer |
| Return | Open the selected client, project, task or invoice |
| → Tab / ← ⇧Tab | Move between the Clients, Projects and Tasks lists |
| ⌘S | Save, in client, project and task windows |
| Esc | Cancel |
| ⌘F | Filter the list that's showing |
| ⌥⌘F | Clear all filters |
| ⌘R | Refresh: load the latest changes |
| ⌘+ ⌘− ⌘0 | Bigger text, smaller text, actual size |
| ⇧⌘D | Dashboard |
| ⌘1 – ⌘4 | Projects, Time, Tasks and Sales reports |
| ⌘5 | Overdue Invoices |
| ⌘6 | Recurring Invoices |
| ⌘7 – ⌘9 | Real Hourly Rate, Quotes Report, Year-End Export |
| ⌘, | Settings |
Good habits and safety nets
Mercerly is built so mistakes are hard to make and easy to undo.
- Problems pop up. If something goes wrong, or needs fixing before you can save, a message appears that you have to click OK on. It won't hide at the bottom of a window.
- Destructive things ask first, and say plainly what will happen.
- Billed work is locked. Invoiced time can't be changed, moved or billed again until you take it off its invoice.
- Invoices are checked before they exist. Review the PDF, then create. Timers are stopped first, and nothing goes on an invoice unless you ticked it.
- Cancel keeps a record; delete doesn't. Cancel anything a client may have seen. Delete only true mistakes.
- Paid is your call. Mercerly never marks an invoice Paid by itself.
- Start your timer first thing and stop it when you switch jobs. If you forget, Log Time fills the gap and Timer History lets you fix entries.
- Watch the orange and red Unbilled amounts: that's work waiting too long to be invoiced.