Weekly Status Update Report Structure
A weekly status update uses the same five labeled sections every week so a sponsor can locate information quickly.
The Half-Minute Reader
Imagine a sponsor who receives one message from your team each week and has only half a minute to read it. That reader is not auditing your calendar. They want to know three things: what changed, what is stuck, and whether anything is about to go wrong. A weekly status update exists to answer those questions quickly.
The format is built around a simple idea: the reader should be able to predict where each answer will appear. Once a reader learns where the blocked items live, they can skip straight to that line. The structure is therefore a reading tool as much as a writing tool. When the structure drifts from one week to the next, the reader has to hunt for information again, and the update stops doing its job.
Tracing the Five Labeled Sections
The template begins with a header line that identifies the customer and the week. After the header come five labeled sections, always in the same order. Each section answers one question the sponsor cares about. Follow the sections in order below and notice that each one hands the reader to the next kind of information: finished work, then requests for action, then insight, then evidence, and finally a forecast.
Each section answers one question. WHAT SHIPPED reports finished work. WHAT'S BLOCKED reports anything that cannot move without help. WHAT WE LEARNED records insight that should influence later decisions. METRIC MOVEMENT shows how the numbers changed. ONE RISK FOR NEXT WEEK names the most dangerous possibility ahead. Because the labels never change, the reader's eye can go directly to the question they came to answer.
Writing Specific Shipped Work and Blockers
Shipped work and blockers share one requirement: specificity. A shipped entry should name the change itself and attach something the reader can inspect, such as a link to a demo, a dashboard, or a pull request. The template's own placeholder reads WHAT SHIPPED followed by a note to give a specific change with a link to the demo, dashboard, or PR. The expected detail is therefore a concrete change plus proof, not a general statement that progress was made.
A blocker is held to the same standard. It must name what is stuck, provide a path to unblock it, and identify an owner who can act on that path. If nothing is blocked, the update should say so explicitly rather than leaving the section blank, because a blank section forces the reader to wonder whether the item was skipped or whether there truly is nothing stuck.
Rewriting a shipped entry and a blocker
A team has a vague week: it did some work on the evaluation suite and is waiting on someone for the data export. Turn these into entries a sponsor can act on.
- 1Name the change itself
Vague version: 'Made good progress on the evaluation suite.' Specific version: 'Added a held-out set of 200 test cases to the evaluation suite.' The specific version says what changed.
- 2Attach proof the reader can inspect
The specific shipped entry gains a link, such as the pull request that added the cases. Now the sponsor can verify the claim without asking anyone.
- 3State the blocker with an unblock path
Vague version: 'Waiting on data.' Specific version: 'The data export for the pilot cohort is stuck because the vendor has not confirmed the schema. Unblock path: a 15-minute call with the vendor contact to confirm the schema.'
- 4Name an owner
The blocker gains an owner, a named person responsible for making the call happen. The sponsor now knows who to follow up with and what decision or action is being requested.
The shipped entry names a specific change with proof, and the blocker names what is stuck, the unblock path, and the owner. Both lines can now be acted on or verified in seconds.
Blocker Versus Risk
Blockers and risks look similar because both involve things that could hurt progress, but they sit in different sections for a reason. A blocker is stopping work now. A risk might stop work later. Placing each in its correct section tells the sponsor whether the team needs help immediately or needs to watch a possibility over the coming week.
The two also differ in what they ask of the reader. A blocker is a request for action, so the sponsor may need to remove an obstacle. A risk is a forecast, so the sponsor needs to know where attention should go and what the team is doing about it. This is why the risk section is limited to one item with its prevention step, while the blocker section can list every item that cannot move without help.
Lessons and Metrics as Evidence
The lessons section asks for one or two specific things from the week that change how the team should think about the rest of the engagement. The point is not a diary of activity. A lesson is useful only if it would alter a future decision, so each lesson should name the decision it affects.
The metric section compares three numbers for each measure: the current value, the value from last week, and the baseline. For the evaluation suite, the template asks for this week's pass rate against last week's. Showing movement against both a recent point and a fixed starting point lets the sponsor see whether a change is a real trend or just noise from one week.
Reading metric movement against two reference points
For the evaluation suite, this week's pass rate is 82 percent, last week's was 76 percent, and the baseline recorded at the start of the engagement was 70 percent. How should the metric line be read?
- 1Compare against last week
82 minus 76 gives a gain of 6 points since last week. This shows short-term movement.
- 2Compare against the baseline
82 minus 70 gives a gain of 12 points since the starting point. This shows the cumulative change over the engagement.
- 3Judge whether it is a trend
A gain that holds against both the recent point and the fixed starting point is more convincing than a single week's jump. The sponsor can see the change is not only noise from one week.
The metric line communicates both the weekly change and the cumulative change, so the sponsor can judge whether the trend is real.
Common Ways an Update Fails
A weekly update usually fails in predictable ways. The reader may be unable to find the answer they need, or the answer they find may not be something they can act on. The before and after view below shows the same week reported two ways.
Common mistake Writing a general statement of progress instead of a specific change
What it looks likeWHAT SHIPPED: Good progress on the pipeline this week.
Why it failsThe reader cannot tell what changed or check it.
Do this insteadName the change and attach a link to the demo, dashboard, or PR.
Common mistake Leaving a section blank when nothing is blocked
What it looks likeWHAT'S BLOCKED: (empty)Why it failsThe reader cannot tell whether nothing is stuck or whether the item was skipped.
Do this insteadState explicitly that nothing is blocked this week.
Common mistake Listing a blocker without an owner or unblock path
What it looks likeWHAT'S BLOCKED: Waiting on the data export.
Why it failsThe sponsor has no way to act on it.
Do this insteadAdd the path to unblock it and name the owner responsible for it.
Common mistake Writing lessons as a diary of activity
What it looks likeWHAT WE LEARNED: We held four meetings and reviewed the backlog.
Why it failsNothing in the statement would change a future decision.
Do this insteadName a lesson that alters a future decision, and say which decision it affects.
Common mistake Listing many risks instead of one
Why it failsA long list dilutes the signal and hides which risk matters most.
Do this insteadName the single most important risk and its prevention step.
Common mistake Reporting a metric without a comparison point
What it looks likeMETRIC MOVEMENT: Pass rate is 82 percent.
Why it failsA single number does not show whether anything moved.
Do this insteadShow the current value, last week's value, and the baseline.
Practice: Rewriting a Week
Rewrite this week's vague update so that a sponsor can act on it in half a minute. Original notes: the team did work on the reporting module, the data export is still stuck, the team learned that testing takes a long time, the pass rate went up, and there are several things that might go wrong. Produce one entry for each of the five sections, using the specificity rules from this article.
Hints
- Use the placeholder pattern from the template: a specific change with a link to proof for WHAT SHIPPED.
- A blocker needs a path to unblock it and an owner. Decide whether the data export belongs in blockers or risks based on whether it is stopping work now.
- For METRIC MOVEMENT, you need the current value, last week's value, and the baseline. If you do not have a baseline, say so explicitly rather than inventing one.
- Choose only the single most important risk, and attach a prevention step.
Key Takeaways
- A weekly status update uses the same five labeled sections every week so the sponsor can predict where each answer appears: WHAT SHIPPED, WHAT'S BLOCKED, WHAT WE LEARNED, METRIC MOVEMENT, and ONE RISK FOR NEXT WEEK.
- Each section plays a distinct role: shipped work records what happened, blockers request action, lessons judge the future, metrics are evidence, and the risk is a forecast. Keep these roles separate.
- Shipped work needs a specific change with a checkable link. Blockers need an unblock path and an owner. If nothing is blocked, say so explicitly.
- Metric movement compares the current value with last week and with the baseline, so the sponsor can tell a real trend from one week's noise. The risk section names one risk with its prevention step.
- Vague, padded, or blank entries make the update fail its purpose. Correct them by making every line specific, verifiable, and tied to a decision or action.