Theory of change vs logframe vs OKRs
A theory of change explains why your work should lead to change, a logframe sets out what you have agreed to deliver and measure for a funder, and OKRs focus your team on what to move this quarter. They are layers of one system, not rivals.
Milestra team · 26 October 2026 · 8 min read
Three tools, three questions
If you work in a nonprofit or NGO, you have probably been asked for all three: a theory of change in a proposal, a logframe in a grant agreement, and OKRs from a new director or board member. It can feel like three ways of writing the same plan. They are not. Each answers a different question.
- Theory of change: Why do we believe our work will lead to the change we want?
- Logframe: What exactly will we deliver and achieve with this funding, and how will we prove it?
- OKRs: What are we trying to move this quarter, and how will we know by the end of it?
Once you see them as answers to different questions, it becomes much easier to decide which you need, and how to stop them drifting apart.
Theory of change: the reasoning
A theory of change maps the pathway from what you do to the long-term change you want, and makes the assumptions along the way explicit. It is usually a diagram with a short narrative.
What it is good for
- Agreeing, inside the organisation and with partners, how change happens
- Spotting gaps: preconditions that nobody is working on
- Deciding what to evaluate, because the assumptions are where programmes most often go wrong
- Explaining your approach to funders and boards in a page
What it is not good for
- Tracking progress week to week
- Holding targets, owners or deadlines
A theory of change covers the whole programme or organisation, and stays fairly stable for several years. Our guide on how to write a theory of change walks through building one.
Logframe: the agreement
A logical framework (logframe) turns part of that pathway into a table: goal, outcomes, outputs and activities, each with indicators, means of verification and assumptions. Many institutional donors require one.
What it is good for
- Agreeing precisely what a grant will achieve, with baselines and targets
- Making measurement concrete: what data, from where, how often
- Accountability: it is the reference point for every report to that funder
What it is not good for
- Day-to-day management. A logframe usually covers several years and changes only by formal amendment.
- Showing the whole organisation. Each funder tends to have its own logframe, so a large NGO can have a dozen that overlap.
See how to create a logframe for a step-by-step method and a free template.
OKRs: the focus
OKRs (objectives and key results) set a small number of qualitative objectives, each with two to four measurable key results, usually for a quarter. They come from the private sector but suit mission-driven organisations well, because they force choices.
What they are good for
- Focusing a team on the few things that matter most right now
- Weekly or fortnightly progress conversations based on numbers
- Linking work across teams, including fundraising, operations and M&E, not just programmes
What they are not good for
- Explaining causal logic (that is the theory of change's job)
- Replacing the indicators you have contractually agreed with a donor
Read OKRs for nonprofits for a full setup guide with examples.
Side-by-side comparison
| Theory of change | Logframe | OKRs | |
|---|---|---|---|
| Main question | Why will this work? | What will we deliver and prove? | What will we move this quarter? |
| Main audience | Team, partners, evaluators | Funder | Team, managers, board |
| Time span | Long term (5+ years) | Life of the grant (often 2–5 years) | A quarter, with annual objectives |
| Format | Diagram plus narrative | Table (matrix) | Short list per team |
| Changes | Reviewed at strategy or evaluation points | By formal amendment | Every quarter |
| Contains targets | Rarely | Yes, with baselines | Yes, for the quarter |
| Has owners | No | Sometimes | Yes, one per key result |
| Best for | Design and learning | Accountability | Execution and focus |
How the three fit together
Think of them as layers.
- The theory of change sits at the top. It describes the change you want in the world and the main pathways to it.
- Logframes take slices of that pathway. Each funded project picks the outcomes and outputs it will deliver and commits to indicators.
- OKRs take the next step on those commitments, plus whatever else the organisation needs this quarter, and give each one an owner and a weekly rhythm.
The practical rule: many of your key results should be logframe indicators, or the leading indicators that drive them. When that is true, a weekly check-in on OKRs is also a weekly check on your donor commitments, and the quarterly report mostly writes itself.
Worked example: a foundational literacy programme
Imagine an NGO running a foundational literacy programme across several districts in two countries, funded by an institutional donor and a family foundation.
The theory of change (extract)
Long-term change: children leave primary school able to read with understanding.
Pathway: if teachers are trained in structured phonics and receive regular classroom coaching, and schools have enough levelled reading books, and children attend regularly, then teaching practice improves and children's reading improves.
Key assumptions: head teachers protect time for daily reading lessons; trained teachers stay in post; caregivers support reading at home.
The logframe (extract)
| Level | Statement | Indicator | Baseline | Target |
|---|---|---|---|---|
| Outcome | Improved reading in early grades | % of Grade 3 learners reading at the expected level | Measured at baseline | Agreed with funder |
| Output 1 | Teachers trained and coached | # of teachers completing training and at least four coaching visits | 0 | Number agreed per district |
| Output 2 | Schools equipped with reading materials | # of schools with the full set of levelled readers | 0 | All programme schools |
Notice the logframe takes the theory of change and adds precision: who counts, how often and against what target.
The OKRs for one quarter
Objective: Every programme school runs a daily reading lesson that works.
- KR1: 90% of trained teachers receive at least one coaching visit this quarter
- KR2: Reading materials delivered to the remaining 40 schools by week 8
- KR3: Average lesson observation score rises from 2.4 to 3.0 out of 4
Objective: Our results data is ready before the donor asks.
- KR1: Midline reading assessment completed in all districts by week 10
- KR2: 100% of coaching visits logged within seven days
KR1 and KR2 in the first objective drive Output 1 and Output 2 of the logframe. KR3 is a leading indicator for the outcome, so the team can see whether reading is likely to improve long before the next assessment. The second objective has nothing to do with any single logframe; it is about the organisation's own reporting habit. Both are legitimate OKRs.
Which one do you need?
- Designing a new programme or strategy? Start with a theory of change.
- Applying for, or managing, a grant from an institutional donor? You will need a logframe, built from your theory of change.
- Struggling to keep work on track between reports, or to align teams? Add OKRs on top of the frameworks you already have.
Most established NGOs end up using all three. The goal is not to choose one, but to keep them linked so they tell the same story.
Mistakes that make them drift apart
- Writing the theory of change for the proposal and never opening it again. Revisit it at least once a year, and when monitoring shows an assumption is not holding.
- Building OKRs that ignore the logframe. If the team's quarterly priorities have no link to what you have promised funders, you will discover the gap at report time.
- Copying logframe indicators into OKRs wholesale. A logframe can have 30 indicators. A team's OKRs should have a handful. Pick the ones that matter most this quarter.
- Treating any of them as paperwork. Each one is only useful if somebody uses it to make decisions.
Keeping them in one place
The easiest way to stop drift is to keep logframe indicators and OKRs in the same system, with each key result linked to the indicator it moves. Milestra lets you do that: goals, key results and logframe indicators sit together, owners update them weekly, and you can produce a logframe-style donor report or a board report from the same numbers. See the features page for how it works, and OKR software for nonprofits and NGOs for how the logframe and OKR views fit together.
Frequently asked questions
Is a theory of change the same as a logframe?
No. A theory of change explains how and why change is expected to happen, including assumptions, usually as a diagram. A logframe is a table that commits a specific project to outputs, outcomes and indicators with targets. A logframe is often built from part of a theory of change.
Can OKRs replace a logframe?
Not for a funder who requires a logframe. The logframe is a formal agreement. OKRs work alongside it as a management tool, helping the team focus each quarter on the indicators and activities that matter most.
Which should we write first?
Theory of change first, then the logframe for each funded project, then quarterly OKRs. If you already have logframes but no theory of change, it is still worth drawing one: it often shows where the logframes overlap or leave gaps.
What is a results framework?
A results framework is a broader term for any structured set of results and indicators, often at organisational level. A logframe is one common type of results framework. Our guide to results frameworks explains the differences.
How many OKRs should a programme team have?
Usually one to three objectives per quarter, each with two to four key results. If you have more than about ten key results for one team, you are probably listing activities rather than priorities.
Try Milestra for free
Put this guide into practice in 10 minutes
- Goals, key results and indicators in one place
- Two-minute weekly check-ins with reminders
- Donor and board reports from live numbers
- Free for up to 5 people · 50% off for nonprofits