At a Glance
What Is a Logframe's Four-by-Four Matrix?
A standard logframe is a four-row, four-column matrix. Rows represent levels of the results chain; columns capture the information each level needs.
| Level | Narrative summary | Indicators | Means of verification | Assumptions |
|---|---|---|---|---|
| Goal / Impact | The population- or sector-level change the program ultimately contributes to | 1-2 indicators (often shared with national statistics or SDGs) | Source of the data, e.g., national survey, external dataset | What must hold at the goal level for program contribution to matter |
| Outcomes | The applied changes in participant behavior, capability, or status | 2-3 indicators per outcome | Source, method, frequency | What must hold for outcomes to produce goal-level impact |
| Outputs | The tangible products and services the program delivers | 1-2 indicators per output | Typically administrative data, monitoring records | What must hold for outputs to produce outcomes |
| Activities | The discrete actions taken to produce outputs | (Usually handled in MEL plan, not logframe) | (Activity records) | What must hold to deliver activities (access, security, staffing) |
Worked Example: A Completed Logframe
The table below fills every cell for a hypothetical district water and hygiene program run by a fictional organization, Healthy Futures. All numbers are illustrative.
| Level | Narrative summary | Indicators | Means of verification | Assumptions |
|---|---|---|---|---|
| Goal | Reduced childhood diarrheal illness in Riverbend District | % of children under 5 with diarrhea in the previous 2 weeks falls from 24% (baseline) to 15% by end of Year 5 | Household survey at baseline and endline; district health facility records | Rainfall and flooding stay within normal ranges; health services remain open |
| Outcome | Households in 60 target villages use safe water and wash hands at key times | 70% of households treat or source drinking water safely by Month 36; 55% of households have a handwashing station with soap and water, observed, by Month 36 | Annual household survey with spot-check observation | Households continue to pay small water fees; no village is displaced |
| Output | Water points repaired and hygiene sessions delivered | 45 water points repaired and functioning at 6-month checks by Month 24; 1,800 households attend at least 3 of 4 hygiene sessions by Month 30 | Water point inspection forms; session attendance registers | Spare parts are available locally; the district approves repairs on schedule |
| Activities | Train 90 village water committee members; repair water points; run hygiene sessions in each village | Activities tracked in the MEL plan (training completed, repairs completed, sessions held, against the workplan) | Training records; repair logs; monthly activity reports | Roads stay passable in the rainy season; trained staff remain in post |
The matrix captures the program's logic: each row must plausibly produce the row above it, and each column must support the narrative in that row. This is why order matters when writing one.
For the conceptual foundation, see logframe and theory of change. For the key comparison, see logframe vs theory of change.
What Order Do You Write a Logframe In?
Write in this sequence. Jumping around is the root cause of most broken logframes.
| # | Step | What happens |
|---|---|---|
| 1 | Anchor in the theory of change | Have a finalized theory of change before drafting. The logframe operationalizes the theory; without one, the matrix has nothing to operationalize. |
| 2 | Write the goal (top row) | One sentence. Population-level change. Aligns with donor strategic priorities where applicable. |
| 3 | Write the outcomes | 2-4 outcomes. Each is an applied change in participants. Each must plausibly contribute to the goal. |
| 4 | Write the outputs | 4-10 outputs distributed across outcomes. Each is a tangible deliverable. Each must plausibly contribute to at least one outcome. |
| 5 | Sketch the activities | Under each output, 2-5 activities. These usually stay in the narrative proposal, not the logframe itself. |
| 6 | Fill indicators and means of verification | Work row by row, specifying 1-3 indicators per row with data source and frequency. |
| 7 | Write assumptions | Working from the bottom row up: at each level, what must hold for that level to produce the level above? |
Only step 6 onward introduces quantitative specifics. The first five steps are about logic, not measurement. Most logframes fail because writers jump to step 6 before the first five are sound.
Writing the Rows
Row 1: Goal or Impact
The goal (or impact, depending on donor terminology) is the population- or sector-level change the program contributes to. It is not something the program alone can produce; it is where the program's contribution lands.
Good goal statement traits:
- Population-level, not program-participant-level ("Reduced under-five mortality in District X" not "Trained 500 health workers")
- Often aligns with national priorities, SDGs, or sector commitments
- Typically shared across multiple programs and stakeholders
- Time-bounded but long-horizon (5-15 years rather than program lifespan)
The goal narrative should be one sentence. Multi-sentence goals are usually two goals pretending to be one.
Row 2: Outcomes
Outcomes are the applied changes in participant behavior, practice, capability, capacity, or condition that result from the program. They are what the program is directly designed to produce, measurable within the program timeframe.
Choose as many outcomes as the causal pathway and management decisions need. One focused outcome can be sufficient; a count alone does not establish scope or quality.
Each outcome must:
- Express applied change, not activity completion ("Trained health workers deliver protocol-aligned care" not "Health workers trained")
- Be attributable at least partly to the program
- Plausibly contribute to the goal
See outcome-indicator for the indicator-level discussion.
Row 3: Outputs
Outputs are the tangible products and services the program delivers. Unlike outcomes, outputs are under direct program control: the program decides how many trainings, kits, construction projects, or sessions to deliver.
A typical program has 4-10 outputs distributed across outcomes. Each output must:
- Count or describe a specific deliverable
- Plausibly contribute to at least one outcome above it
- Be within the program's direct control (not dependent on participant or external action)
See output-indicator for the indicator-level detail.
Row 4: Activities
Activities are the discrete actions the program takes to produce outputs: conducting trainings, distributing materials, recruiting participants, building infrastructure. Activities are frequently described in the proposal narrative rather than entered in the logframe matrix itself; some donor logframe templates include them, others do not.
Where activities are included, keep them at a reasonable level of abstraction. "Deliver 5-day training curriculum to 200 health workers" is a good activity. "Arrange transport to training venue, provide lunch, issue certificates" is sub-activity detail that belongs in the work plan, not the logframe.
Writing the Columns
Column 2: Indicators
Each row needs 1-3 indicators that measure whether that row has been achieved. Indicators at different levels serve different purposes.
- Goal Indicators: often inherited from national statistics (under-five mortality, HIV incidence, literacy rates, food security scores). 1-2 per goal. Measurement usually by secondary data rather than program-run surveys.
- Outcome Indicators: measure applied change, 2-3 per outcome. May use administrative records, assessments, or surveys. Comparable rounds are needed to estimate change; endpoint attainment and some causal designs can use different data structures.
- Output Indicators: measure deliverables, 1-2 per output. Usually from administrative or monitoring records.
Every indicator should pass SMART criteria before entering the logframe. See SMART indicators deep-dive for the test. For the standard-vs-custom decision, see custom vs standard indicators.
Column 3: Means of Verification
For each indicator, name the specific data source and method. A means of verification is not "survey" or "monitoring data"; it is "annual household survey conducted in September using JMP WASH questions" or "quarterly training attendance roster reviewed by M&E officer."
Donor reviewers assess whether the means of verification is feasible given the program's budget and capacity. A proposal with ambitious indicators but vague verification is a credibility problem.
See means of verification for the full discussion including typical categories and common mistakes.
Column 4: Assumptions
Assumptions are conditions outside the program's control that must hold for the program's logic to work. At each row, the assumption answers: "what must be true for this row to produce the row above?"
Examples:
- Activity-to-output assumption: "Field staff can access target communities throughout project lifespan."
- Output-to-outcome assumption: "Trained participants remain in their roles long enough to apply new skills."
- Outcome-to-goal assumption: "Broader sector reforms (outside program control) continue, allowing outcome gains to contribute to population-level change."
Strong assumptions are specific enough to be tested during implementation. "External context remains supportive" is useless; "National government's water policy reforms remain on track through project period" is testable.
Assumptions link to the risk register in the full proposal: each assumption is something the risk register may contain as a watch item, with a mitigation plan.
Testing the Logic
What Is the Vertical Logic Test in a Logframe?
The vertical logic test asks: does each row plausibly produce the row above it?
Walk the matrix from the bottom up:
- Do the planned activities produce the stated outputs?
- Do the outputs plausibly produce the stated outcomes?
- Do the outcomes plausibly contribute to the stated goal?
Where any step breaks (outputs that do not meaningfully contribute to outcomes, outcomes that do not plausibly aggregate toward the goal), the matrix needs revision before submission. Common vertical logic failures: outcomes too distant from outputs, goals disconnected from realistic outcomes, outputs that duplicate without building toward an outcome.
What Is the Horizontal Logic Test in a Logframe?
The horizontal logic test asks: for each row, do the indicators, verification, and assumptions hang together?
- Do the indicators actually measure what the narrative summary describes?
- Is the means of verification feasible for each indicator?
- Are the assumptions specific enough to be tested during implementation?
Weak horizontal logic produces logframes that look complete but do not function. Common failures: generic assumptions that do not constrain anything ("external context remains supportive"), means of verification that the program cannot actually execute ("national household survey" with no survey in the budget), indicators that sound right but do not measure the narrative ("women empowered" measured by "women attending meetings").
Mistakes & Checklist
Sector Examples
The scenarios below are illustrative. Their figures, costs, and review outcomes are teaching assumptions, not reported studies or evidence of donor approval.
Health: Immunization Program, East Africa
A 3-year program to improve immunization coverage in 2 districts. Logframe: goal = "Reduced child mortality from vaccine-preventable diseases in target districts" (measure: an appropriate cause-specific mortality source if available; DTP3 coverage is a service-coverage outcome and must not be presented as a mortality measure). Outcomes: (a) "Health workers deliver immunization services per national schedule," (b) "Caregivers bring eligible children for scheduled immunization." Outputs: 4 per outcome covering training, cold chain, supportive supervision, community mobilization, SMS reminders, and clinic upgrades. Indicators totaled 16. Assumptions included "National immunization schedule remains stable" (goal-level) and "Community acceptance of vaccination does not decline due to misinformation" (outcome-level).
Education: Girls' Education Program, South Asia
A 5-year program to improve secondary school retention among girls aged 11-16. Logframe: goal = "Increased secondary school completion rates for girls in target districts." Outcomes: (a) "Families support daughters continuing to secondary school," (b) "Girls stay enrolled through secondary school transitions." Outputs: mentor program for 2,400 girls, community dialogue events, teacher training on gender-responsive pedagogy, stipend delivery, school-based menstrual health support. 18 indicators. Critical assumption (outcome-to-goal): "Existing government policies supporting girls' education remain in force."
WASH: Rural Water Program, West Africa
A 4-year program to improve safe water access for 80 rural communities. Logframe: goal = "Reduced diarrheal disease in under-five children in target communities" (indicator: population-relevant diarrhea prevalence or incidence with an explicit eligible population, period, and denominator; facility counts separately describe recorded service burden and depend on care seeking). Outcomes: (a) "Households use safely managed water sources," (b) "Community water systems are sustainably operated." Outputs: water points installed (by type), water committees trained, water quality testing program, household hygiene promotion. 14 indicators using JMP service ladder categories for SDG 6.1 alignment. Assumption (activity-to-output): "Community contributions (land, labor) materialize per commitment."
Food Security: Livelihoods Program, Sahel
A 3-year livelihoods program for pastoralist communities. Logframe: goal = "Improved food security among pastoralist households through drought cycles" (indicator: household hunger scale among program communities). Outcomes: (a) "Households diversify income sources," (b) "Savings groups provide financial resilience." Outputs: agricultural training, savings group formation, small-business grants, livestock vaccination campaigns. 12 indicators. Seasonal disaggregation (transhumance/settled) built into outcome indicators. Critical assumption: "No catastrophic drought in target region during program period."
Common Mistakes
Mistake 1: Writing activities first and aggregating up. The temptation is to start with what you plan to do and build the goal from there. This produces logframes where outputs do not plausibly produce outcomes and outcomes do not contribute to the goal. Write top-down.
Mistake 2: Confusing outputs with outcomes. "Number of trainings held" is an output. "Percentage of trained workers applying new skill" is an outcome. Outputs are what the program delivers; outcomes are what changes in participants because of the delivery. Getting this wrong is the most common logframe error.
Mistake 3: Vague assumptions. "External context remains supportive" is a placeholder, not an assumption. An assumption should be specific enough that you could check at program mid-term whether it still holds. Write assumptions as testable statements.
Mistake 4: Indicators that do not measure the narrative. If the outcome narrative is "women empowered," and the indicator is "women attending meetings," the indicator measures attendance not empowerment. Either the indicator or the narrative is wrong; align them.
Mistake 5: Means of verification that the budget cannot support. An outcome indicator requiring a national household survey implies the budget funds that survey. If it does not, the indicator is not executable. Verify feasibility before committing the indicator.
Mistake 6: Too many indicators. 10-30 indicators across a mid-sized logframe is typical; beyond 30 you usually have bloat. See mistake too many indicators. Each additional indicator adds real monitoring cost.
Mistake 7: Goal aligned to program scale rather than population. "Strengthened capacity of 5 partner organizations" can be an organizational outcome when it measures actual capability change. Classify it against the results chain rather than treating all capacity as an output. A goal should describe population- or sector-level change, typically beyond what any single program can fully produce.
Mistake 8: Logframe that does not match the narrative proposal. The logframe is an operational restatement of the theory of change. If the narrative describes one logic and the logframe shows a different one, reviewers notice. Update both together when either changes.
Logframe Completion Checklist
Run through this before submitting a logframe with a proposal or locking it into the MEL plan.
Matrix structure:
- Goal, outcomes, outputs rows filled in top-down sequence
- 2-4 outcomes, 4-10 outputs distributed across them
- 1-3 indicators per row
- Means of verification named specifically (source + method + frequency) for every indicator
- Assumptions specific enough to be tested during implementation
Logic tests:
- Vertical logic passes: each row plausibly produces the row above it
- Horizontal logic passes: indicators measure narrative; MoV supports indicators; assumptions constrain the logic
- Logframe matches the theory of change narrative
Indicator quality:
- Every indicator passes SMART criteria
- Standard/custom mix documented
- Baselines collected or baseline study planned before committing targets
- Targets realistic and baseline-anchored
Means of verification:
- Data sources named specifically, not generically
- Collection frequencies specified
- Budget supports the planned verification approach
Assumptions:
- One or more assumptions per row (except the top)
- Assumptions testable during implementation
- Critical assumptions linked to the risk register
For the broader MEL plan integration, see how to write a MEL plan. For the proposal-section integration, see how to write the M&E proposal section. For the decision between logframe and theory of change, see logframe vs theory of change. For current document workspaces, see the Playbooks catalog.