How to Set Up Milestone Payments for Your Next Project (Step-by-Step)

Holdyn · Apr 8, 2026 · 5 min read

FreelancersGuides

5 min read

Milestone payments are the gold standard for project-based work. Instead of one risky lump sum, you break the project into phases — each with its own deliverable and payment. The client pays as value is delivered, and the freelancer or agency gets paid as they go.

Here’s exactly how to set up milestone payments, step by step.

Frequently Asked Questions

How many milestones should a project have?

3–7 milestones for most projects. Fewer than 3 and you lose the risk-distribution benefit; more than 7 creates administrative overhead without added value. A good rule: each milestone should represent 1–3 weeks of work.

Can milestones be changed after the project starts?

Yes, through formal amendments. Both parties review the proposed change, the amounts are adjusted, and funds are moved accordingly. This is much cleaner than trying to negotiate informally — the amendment creates a clear paper trail.

What happens if I complete a milestone but the client doesn’t release payment?

You can request auto-release (if configured) or file a dispute with evidence. In most platforms, if the client doesn’t respond within a defined window, the funds release automatically or move to mediation. You never have to chase the payment yourself.

Should the first milestone be bigger or smaller?

Bigger. Front-load 20–30% on the first milestone to cover your initial research, planning, and discovery work. This also filters out tire-kicker clients — serious clients will fund a real first milestone; curious clients won’t.

What’s the ideal size for the final milestone?

Small — 10–15% of total. A small final payment reduces the client’s incentive to drag out the review, and it limits your exposure if there’s any delay. Big final payments are the #1 source of “just a few more changes” hostage situations.

TL;DR

Define 3–7 milestones — specific, measurable, sequential
Create the transaction — choose Event-Based type
Add payment events — title, amount, release method per milestone
Set terms and review — custom terms, revision limits, then send
Fund and release each phase — payer funds, payee delivers, funds release

Step 1: Define Your Milestones

Before you touch the platform, plan your milestones. Good milestones are:

Specific: “Homepage design approved” not “do some design work”
Measurable: There should be a clear deliverable that can be reviewed
Sequential: Each milestone builds on the previous one
Balanced: Distribute the budget roughly proportional to the effort

Aim for 3–7 milestones per project. Fewer than 3 defeats the purpose; more than 7 creates administrative overhead.

Step 2: Create the Transaction

Go to your Home page and click Send (if you’re paying) or Receive (if you’re getting paid).
Select Conditional Payment as the payment mode.
Enter your counterparty’s name and email address.
Choose Event-Based as the transaction type.
Add a title and description for the overall project.

Step 3: Add Your Payment Events

In the Payment section, click Add Payment Event for each milestone:

Give each event a clear title (e.g., “Phase 1: Discovery & Wireframes”)
Set the amount for each event
Choose the release method — automatic (releases on a date) or manual (you approve when ready)
Set the funding schedule for each event

The total of all events becomes the full project value, calculated automatically.

Step 4: Set Terms and Review

Add any custom terms (revision limits, grace periods, etc.), review the full transaction summary, and click Send. Your counterparty receives a notification with the complete transaction details. They review everything and approve with their e-signature.

Step 5: Fund and Release Each Milestone

The payer funds each milestone from their Holdyn wallet
The payee completes the work and marks the milestone as done
If auto-release is set, funds release on the scheduled date
If manual release, the payer reviews and releases the funds

Pro Tips for Better Milestone Structures

Front-load the first milestone (20–30%): Covers your initial investment and shows the client you’re serious.
Keep the final milestone small (10–15%): Gives the client incentive to approve quickly.
Include a “discovery” milestone: Charge for research and planning. This filters out tire-kickers.
Set realistic dates: Build in buffer. Delivering early beats missing a deadline.

Start Structuring Your Projects

Milestone payments eliminate the biggest risks in project work — non-payment, scope creep, and endless revision cycles. When each phase is funded before it starts and released when it’s delivered, both parties stay aligned.

Holdyn makes this easy — event-based conditional payment transactions with per-milestone funding, custom terms, and e-signatures. Set up your first project in under 5 minutes.