UpStream Reporting includes dozens of built in reports, with filters for every parameter, allowing you to see your data in more ways than ever. With the UpStream Reporting extensions, you can create Gantt Charts, pie charts, bar graphs, calendars, tables, and more.  Choose from dozens of built in reports, and filter by any combinations of parameters or custom fields to zero in on the data that you want to see.

Plugin Version: 1.3.2
 
WordPress plugin UpStream Reporting

Plugin Features

The plugin is a powerful tool for WordPress users looking to visualize data easily within their website. Offering a range of customizable charts and graphs, it allows for seamless integration and representation of information in a visually appealing way. This plugin provides a user-friendly experience, making it suitable for beginners and advanced users alike. With its intuitive interface, users can generate reports effortlessly, enhancing the overall functionality of their WordPress site.

Offering a variety of chart types such as bar graphs, pie charts, and line graphs, the plugin allows for versatile data representation according to user preferences. Its interactive features enable users to drill down into specific data points, offering a detailed view of the information being presented. The plugins responsive design ensures that the charts and graphs adapt smoothly to different screen sizes, providing a consistent user experience across devices.

Users have the flexibility to import data from various sources, including CSV files and external databases, making it convenient to populate their charts with up-to-date information. The plugins robust data management capabilities enable users to organize and filter data efficiently before displaying it visually. With options for real-time data updates, users can ensure that their reports are always current and relevant to their audience.

One of UpStream Reporting standout features is its ability to schedule automated report generation, allowing users to set up regular reports to be sent via email or saved directly within the WordPress dashboard. This automation saves time and effort for users who require frequent and consistent report updates. Additionally, the plugin offers advanced customization options for fine-tuning the design and layout of the reports, ensuring they align with the websites branding and aesthetics.

Overall, the plugin streamlines the process of data visualization and reporting for WordPress users, offering a comprehensive solution for presenting information in a clear and engaging manner. With its rich feature set and user-friendly interface, it empowers users to create professional-looking reports without the need for extensive technical knowledge or coding skills. Enhancing the analytical capabilities of WordPress websites, the plugin is a valuable asset for those seeking to leverage data effectively within their online platforms.

Specifications:

Release date: 11-10-2020
Last updated: 03-03-2021
Type: Paid
License: GPL 
Subject: Style & Design for UpStream
Compatibility: W5.x
Includes: Plugin
Language packs: English
Developer: UpStream

Rating:
4.4731707317073 1 1 1 1 1 (205 Votes)

Download by subscription!

You need to log in on the site and purchase a club subscription!

Share with your friends!

 

A Practical Guide to UpStream Reporting for Project Reports

This guide to UpStream Reporting will help you prepare project data for analysis, choose the right report type, set precise filters, and verify that a manager or client gets information they can trust. We’ll cover the path from UpStream tasks and milestones to a table, chart, calendar, or Gantt chart, and show how to avoid mistaking a random collection of numbers for a management decision.

Reporting is an add-on for the core UpStream plugin, so it doesn’t create a standalone system of record or fix project entries that are empty or contradictory. Its strength lies elsewhere: it lets you examine the projects, milestones, tasks, and bugs already in UpStream from different angles, combine filters, sort the results, and print or export just the slice you need. This is especially useful when a team manages several client projects on its own WordPress site and needs to answer a specific question instead of asking how things are going in general: Which tasks are stalled? Which deadlines are approaching? What’s complete? Which costs need attention?

Don’t start by looking for the prettiest chart. First, decide what question the report needs to answer. A table is useful for reviewing and exporting a list, a calendar for upcoming dates, a bar or pie chart for breaking down statuses, time, or amounts, and a Gantt chart for discussing sequence and timing. The same project can be represented accurately in all of these formats, but each one answers a different question. That’s where UpStream Reporting’s practical value lies.

UpStream Reporting guide cover showing project data, filters, and a Gantt chart
This conceptual diagram shows how UpStream work records can lead to a report that supports a decision instead of simply displaying a chart.

What Questions Reporting Can Help You Answer

Core UpStream stores project work in familiar records: projects have a status and dates, milestones group tasks, tasks have assignees, deadlines, statuses, and progress percentages, and bugs can be tracked by severity, status, and owner. Reporting turns these records into a set of built-in reports and lets you filter by standard or custom fields. It’s best understood as an analysis layer on top of your project records, not as a substitute for consistent team practices.

One useful application is a weekly review of schedule risks. A manager chooses a task or project report, keeps only active items, sets a date range, and sorts the results so the earliest dates appear first. This creates a working review queue: it doesn’t promise that everything will be done on time, but it highlights items to discuss with their assignees. A chart can’t show a missed deadline if no date was entered. And if statuses aren’t updated, the share marked “in progress” reflects data-entry habits rather than actual progress.

Another use is discussing project status with a client. An internal table with every note and administrative field usually isn’t appropriate for that conversation. A calendar of upcoming milestones or a Gantt chart showing dates alongside progress is a better fit. Before sharing a report, check which data the recipient’s role is allowed to see. Reporting helps you filter the data, but it doesn’t replace access and visibility settings in UpStream.

A third use is reviewing workload and actual costs. This becomes more meaningful when Reporting is used with the time and budget tracking add-on. Reports can then draw on recorded time, budgets, and actual amounts for projects, milestones, tasks, and bugs. Be careful not to confuse hours with workdays. UpStream treats time filter values as hours. The workday length setting can make the display easier to read, but it doesn’t change the underlying time entry.

A fourth use is finding recurring causes of delays or defects. If your organization has added custom fields through Custom Fields, such as work type, priority, intake channel, bug browser, or an internal category, you can use those fields to filter a report. This kind of breakdown is useful only if the team uses values consistently. If different managers enter arbitrary words in the “priority” field, the report may look polished but its groupings won’t be reliable.

Who Should Use It, and When Another Approach May Fit Better

UpStream Reporting is a good fit for an agency, studio, in-house team, or service department that already manages projects in UpStream and wants to analyze those records without manually copying every list into a separate spreadsheet. It makes sense when projects, milestones, tasks, and bugs all matter, and reports need to be available as tables, charts, calendars, or timelines. The add-on is most useful when dates, assignees, statuses, and progress are updated as part of everyday work rather than once a month before a meeting.

It may not be a good fit if your team only needs a kanban board with quick card movement, or a dedicated financial system with accounting rules, approvals, and tax calculations. Reporting can display data entered in UpStream, but it doesn’t replace a separate accounting system. Don’t expect it to reconstruct history if the team didn’t track time, enter dates, or use statuses consistently. In that case, the first priority is to agree on a minimum standard for completing project records, not to choose a chart palette.

Why Good Reports Depend on Good Data Before You Set a Filter

Reports are built from the values in project records. That may sound obvious, but most disappointments start here: a team debates a chart when the real problem is the source data. UpStream links tasks to milestones, and task progress contributes to the progress of the milestone they belong to. A wrong status, a missing assignee, or a date mentioned only in a note can therefore change what the report appears to say. A report shouldn’t be where data gets “filled in” by guesswork.

Before setting up regular reports, decide who owns four essential groups of information: project dates, milestones, work tasks, and exceptions. For a project, track its status, start date, and end date. For a milestone, record an owner, dates, and a clear outcome. For a task, record an assignee, status, progress, and milestone. For a bug, record its description, severity, status, deadline, and owner. Add custom fields only when you actually plan to filter or compare by them. Over time, each unnecessary optional field becomes another source of missing data.

It helps to agree in advance on which statuses count as “active,” “complete,” and “needs attention.” Teams don’t all have to use the same terminology, but a single report shouldn’t combine equivalent states under different names. If “done” means published to one manager and handed off for review to another, the overall percentage will be misleading. Write a short internal description of each status and test it with one project before using it across the portfolio.

A useful check: Before filtering for low-progress items, open a few source records. If the visible percentage, date, and status don’t explain the actual situation without verbal clarification, fix the data-entry rules first and build the report afterward.

Prepare WordPress and Install the Add-On Without Losing Source Data

Start with a copy of the site or a staging site if the live site already contains active client projects. This isn’t because Reporting is meant to change existing records; the add-on is designed for analysis. The reason is simpler: setting up the full combination may reveal that statuses, custom fields, roles, or time-tracking data need to be standardized. It’s better to test those organizational changes where clients can’t see the interim setup.

Core UpStream must be installed and active before you add Reporting. In WordPress, open Plugins, upload the add-on archive using the standard installation process, install it, and click Activate. After activation, don’t jump straight to creating a client report. First, confirm that the expected options appear in the UpStream menu and that existing projects, milestones, tasks, and bugs open without errors. If your process uses custom fields or time tracking, confirm separately that those add-ons are active too.

The add-on’s product page lists minimum WordPress and PHP requirements, but for a specific site, it’s more important to check that the entire setup works together. An older caching add-on, a customized admin theme, role changes, or another project management plugin can affect the interface. Don’t conclude there’s a conflict based on one empty report. First, check whether any records meet the filter conditions. An empty report often means the filters are too restrictive, not that the installation failed.

A Small Test Set to Check Before Your First Report

Create or choose one safe test project with at least two milestones and several tasks with different values. Don’t fill it with fake data that’s hard to interpret. It’s better to model a small but realistic cycle: prepare materials, build, review, and fix issues. Give one task an earlier deadline and another a later one; assign one task an owner and give another a different type of work; use different statuses and progress percentages. If time tracking is available, add a few time entries manually and, if needed, enter budget values.

This test set is a reference for checking reports, not a management demo. Once you apply a filter, you’ll know why a particular record should appear or disappear. That makes it easier to tell a problem from an expected result. If a task at 40 percent progress doesn’t appear in a “30 to 70 percent” report, check the range and confirm that you selected the right report type. If it appears but shows the wrong assignee, check the assignment on the source record rather than trying to correct the exported value.

What to Check in Project Records

  • Project: Enter the status, start and end dates, client, and owner wherever those fields are part of your setup.
  • Milestone: Give it a clear name, dates, an owner, and a related set of tasks.
  • Task: Set the assignee, current status, progress percentage, deadlines, and correct milestone.
  • Bug: If you include bugs in reports, enter their severity, owner, deadline, and status, and describe the issue clearly enough to understand it.
  • Custom fields: Choose values from an agreed set instead of entering different versions of the same term.

Review permissions separately. UpStream has roles and capabilities, and its advanced permissions add-on lets you set access to records and fields. Don’t assume a report is safe for every role just because the project is restricted on the public-facing site. Check the report with a client account and a regular team member account. Internal notes, amounts, and bug details should be visible only to the people allowed to see them under your access model.

Choose the Report: Start With the Record, Then the Question

With Reporting, it’s useful to think in the reverse order from how you might approach a conventional pivot table. First, name the record type: project, milestone, task, or bug. Then formulate the question, and only after that choose how to display the data. This order helps avoid a common mistake: opening an appealing chart and then trying to make the data fit it.

For example, “Which tasks need to be discussed today?” is a question about tasks. A table filtered by active status, deadline, and assignee is a good way to answer it. “Which milestones make up the work plan through the end of the month?” is a question about milestones and is easier to read in a calendar or Gantt chart. “Which tasks have the most recorded time?” is a question about tasks with time entries and requires Time Tracking. “How many projects are complete?” usually calls for a project report filtered by status, not a manual tally of task percentages.

Match the question to a good starting report
Question Record type Useful view What to check before reporting
Which tasks are overdue or coming due? Tasks Table sorted by date Dates, status, and assignee are filled in
How are milestones distributed over time? Milestones and tasks Gantt chart or calendar Start and end dates aren’t placeholders
Where is recorded time concentrated? Projects, milestones, tasks, or bugs Pie chart and a table for validation Time Tracking is active and entries are in hours
Which types of bugs keep recurring? Bugs Table or bar chart Severity and custom fields are filled in consistently

In this approach, a table isn’t a “basic” or second-rate option. It provides evidence for any chart. Before reporting that most of the time went to a particular milestone, open a table with the same filters and inspect several rows. If you see unexpected items, look for the cause in the filters, date range, or source records. That takes less time than explaining to a client why yesterday’s chart had to be redone.

Conceptual UpStream Reporting task report with filters and a result check
This instructional mockup shows the right sequence: select a record type, set filters, choose a view, and review the rows before sending the report.

Keep Different Levels of Analysis Separate

A project report answers a high-level status question. A task report can show why a project is off track, but it doesn’t have to match the project-level view exactly. A milestone with a high completion percentage may contain one overdue critical task, while a project that looks healthy may still have several old bugs outside the selected date range. It’s useful to prepare two related views: one for an overview and another for the details. In a review meeting, show the overview first, then move to a prepared detail table.

This approach doesn’t require complex automation. Just document the names and filters for a few recurring reports in your team’s instructions. For example: “Active tasks without an assignee,” “High-severity bugs with no status update,” or “Time by task for the current project.” The names are for people, not the software: they remind the team what each report checks and which source fields must not be left blank.

Set Up UpStream Reporting: Build a Useful Data Slice, Not a Decorative Chart

A detailed setup should start with a small, verifiable condition. Open the built-in report you need and apply one filter that’s easy to check against your test set, such as a specific assignee, status, or progress range. Apply the setting, review the output, and only then add another filter. If you enter all conditions at once, you won’t know which one removed a row you expected to see. For a recurring report, this is more than a convenience; it makes the report repeatable.

Reporting supports combinations of filters and custom fields, so it’s well suited to focused questions. But how filters interact matters more than how many fields you add. If you set an assignee, date range, status, progress, and work type at the same time, you’re asking for records that meet every condition. The narrower the data slice, the greater the chance you’ll get no rows. An empty report is useful only if you can explain why it’s empty.

A Basic Order for Setting Up Filters

  1. Choose a record type. Confirm that the report covers the projects, milestones, tasks, or bugs you need to make a decision about.
  2. Set a date range. Use dates to define the question’s time frame, not as a substitute for status. A deadline alone doesn’t tell you whether work is complete.
  3. Add a status. Keep only the statuses that match the question: active, complete, awaiting review, or another agreed set.
  4. Add an owner or client. This separates an individual work queue from a report covering the whole portfolio.
  5. Set a numeric range. Add progress, time spent, budget, or actual amount only after checking the unit of measurement.
  6. Apply a custom field. Use it when it distinguishes causes, work types, or segments, rather than simply repeating the task name.
  7. Sort the results. For an operational review, deadlines, severity, or the size of a variance are usually more useful than alphabetical order.

After each step, check not just the number of rows but also the first and last entries. They’re a quick way to catch a reversed sort order or an item with an unexpected date. For a deadline report, open the earliest and latest tasks. For a status report, check whether the team uses an alternate status label that isn’t in the agreed list.

Progress Percentages and Dates Measure Different Things

A progress percentage shows how much work is reported as complete; a date marks a calendar boundary. Problems arise when the two are treated as one measure. A task that’s 80 percent complete can be critical if its deadline has passed and the remaining 20 percent is blocking a milestone. A task at 10 percent may be on track if it’s scheduled to start later. A “30 to 70 percent complete” report can help find work in progress, but it doesn’t replace a deadline report.

A practical option is to prepare two reports for the same meeting. The first shows active tasks sorted by how soon they’re due. The second uses the same projects but highlights a middle range of progress. Comparing the two shows more than just “little has been done.” It reveals combinations such as an early deadline and low progress, a later deadline and high progress, or a task with no progress that hasn’t changed status in a while. Don’t turn the list into a way to punish assignees. Use it to start a short review of the blocker, the next action, and a revised date.

When a Custom Field Helps, and When It Undermines a Report

Custom fields are useful when they capture a consistent attribute that the standard records don’t cover. For a web studio, that might be service type, test environment, or feedback channel. For a support team, it could be request category or whether a bug can be reproduced. For a content team, it might be publication type or approval stage. After Custom Fields is installed, fields can be assigned to projects, milestones, tasks, bugs, and files, so check which record type contains the field you need. You can’t reliably search for a bug type in a project report if the value exists only on bug records.

Don’t use free text for an attribute you plan to chart regularly. “Revisions,” “revisions,” “rev.,” and “minor revision” may look similar to a person, but the filter treats them as different values. A list, category, or label with a limited set of options is more reliable. Before migrating old data, choose a default value for historical records if appropriate. Otherwise, reports using the new field may start with a large, hard-to-interpret group.

Time and Budget Reports: Details You Can’t Afford to Miss

Reporting becomes much more useful for analysis when paired with Time Tracking and Budgeting. This is a separate data layer: time and amount entries are added to tasks and bugs, then can be rolled up at the project level. Reports can break down time spent, budgets, and actual costs for projects, milestones, tasks, and bugs. The reporting add-on doesn’t create these entries automatically. If people don’t log time, or fill it in from memory once a quarter, a pie chart may be mathematically accurate but still tell you little about the work.

First, agree on what counts as time: hands-on work, client meetings, bug fixes, review, preparation, or all of these. Then decide how often people should enter it. Daily or weekly updates may be enough for a small team. Client billing may require a stricter process. Don’t treat the timer alone as proof of productivity. If it isn’t stopped, it records all elapsed calendar time, including overnight. The totals therefore always need a human review.

The Work Hours Per Day setting in UpStream - General determines how the software displays days and hours. It can make a report easier to read, but it shouldn’t obscure the underlying unit. When you set a time-spent filter in Reporting, enter hours, not workdays. If your organization defines a workday as seven hours, 14 hours may display as two days under that setting, but the filter boundaries still need to make sense as 14 hours.

Diagram of time and budget filters in UpStream Reporting, with hours and totals to check
This conceptual map connects time and budget entries to report filters and shows why the unit of entry and selected record type matter more than the chart format.

How to Check Totals Before Sharing Them

Start with a small data slice: one project, task, or milestone with known entries. Compare the expected total with the report’s table. Then expand the range to include several tasks and check again for unexpected records. Move on to a pie or bar chart only after that. A chart makes proportions easy to see, but hides the details behind them.

If a report shows a notable cost overrun, don’t make a decision based on one bar. Open the records with the highest values and find out what was logged: task work, a bug fix, work by several users, or a timer that was left running. If the data is wrong, correct the source entry according to your process and rerun the same report. If the data is right, the report has done its main job: it has identified where a management discussion is needed, not handed down a verdict on the project.

A quick setup check: You should be able to explain a good data slice in one sentence: which record type you selected, which conditions you combined, what unit the value uses, and why each row appears in the report.

A Practical Example: Reporting on an Agency Project With Tasks and Bug Fixes

Consider a realistic but safe-to-reproduce example. A web studio is managing a client website launch in UpStream. The project is divided into milestones called “Content,” “Build,” “Review,” and “Launch.” Each milestone contains tasks with assignees and dates, and tester feedback is recorded as bugs with severity levels. The manager needs a weekly report that answers two questions: What could put the next milestone at risk, and where is the most recorded time going?

The goal isn’t to give the client the entire internal history. It’s to prepare for an objective discussion. You’ll need an active project, agreed-on statuses, dates on tasks, assigned owners, several time entries, and severity values for bugs. If time tracking isn’t in use yet, skip that part of the example and stick to deadlines, progress, and bugs. Don’t fill out a presentation with zeroes just to make the analysis look complete.

Step 1: Check the Project Structure Before Opening Reports

Open the project and review it as the source of the future report. Confirm that the content-preparation task belongs to the right milestone, the build task has an owner and planned deadline, and the review issue has a severity and owner. Also check for tasks without a milestone. They may be perfectly valid in your process, but they need explaining in a discussion about sequence because they don’t fit into the milestone structure.

Next, agree on which statuses to exclude from the operational report. Completed items often don’t belong in a list of upcoming risks, but they may be useful in an overall progress chart. Don’t change a status just to shape the report. If a task has passed review but hasn’t been formally closed, use the appropriate status and interpret it the same way in future weeks. Comparisons over time will then reflect the work rather than changing criteria.

Step 2: Build a Queue of Upcoming Risks

In Reporting, choose a task report. First, limit it to the current project or client if your data includes several projects. Then keep active statuses and set the date range you want to review. Add a progress range only if it helps prioritize work. For example, a manager could look for tasks with low progress and an approaching deadline, but shouldn’t treat that view as the only proof of risk.

Sort the table by date so the soonest deadlines appear first. Check the first three rows. For each one, ask a few quick questions: Is there a real assignee? Is anything blocking the work? Is the date current? Does the percentage match the assignee’s update? If the information conflicts, correct the source record and rerun the filter. That matters more than editing the export by hand. The source data should remain the source of truth.

Turn the Table Into Decisions for the Meeting

  • Don’t read every row aloud. Focus on items with an approaching deadline, no assignee, low progress, or a high-severity bug.
  • Record an action for each item. It might be assigning an owner, confirming a date, splitting an oversized task, or reviewing a blocking bug.
  • Don’t rewrite past facts to make the report look tidy. Correct clear data-entry errors, but don’t rewrite history to smooth out the chart.
  • Keep the filters consistent. The next meeting should use comparable conditions; otherwise, changes over time may be meaningless.

Step 3: Review Time, Budget, and Actual Costs

If Time Tracking and Budgeting is active for the project, choose a report for the record type where the team enters its data. Tasks are often useful for reviewing studio workload because they show which specific work accounts for the largest share. A milestone or project report may be better for discussing a larger body of work. Start with a date range, then add a time or amount threshold if the question calls for one. For example, you could look for tasks that took longer than the agreed internal estimate.

Don’t assume that a large share of recorded time is a problem. Complex work may genuinely require more resources. Compare the amount with the task’s scope, stage, and notes first. If it makes sense, the chart confirms the planned workload. If a small task unexpectedly exceeds the main milestone, open its record. The cause may be an incorrectly entered duration, time logged against the wrong task, or a timer left running. Investigating it is a normal part of checking the report, not a sign that Reporting is malfunctioning.

Step 4: Create a Separate Report for Bugs

A bug report can help more than just technical teams. It can show where feedback is piling up before launch, who needs to respond, and which types of problems keep recurring. Start with active bugs in the selected project. Then add severity and due date if the team actually maintains those fields. Don’t hide important bugs with no deadline; the missing date may itself point to a process problem.

If Custom Fields is used for the test environment, device type, or intake channel, add those filters one at a time. This may reveal, for example, that a group of issues is associated with the same testing context. Don’t infer a technical cause from a matching field alone. A report can reveal a pattern, but the diagnosis still needs to be confirmed by reproducing the issue, reviewing its description, and having a developer investigate it.

UpStream Reporting example for an agency project with milestones, tasks, time, and bugs
This conceptual workflow shows how to review one project for deadlines, workload, and open issues without mixing different levels of data.

Check the Report Before Exporting, Printing, or Discussing It

Reporting’s export and print options are useful once you’ve checked the data slice. Don’t treat an exported file as a draft that will eventually become the only source of truth. First, confirm the filters in the interface: record type, date range, statuses, numeric limits, sort order, and custom fields. Then open several records in the report and compare their values. Only after that should you send the table or chart to someone else.

A good report check has three levels. At the set level, confirm that the row count and record list are close to what you expect. At the row level, pick a few records with a clear history and check their status, deadlines, assignee, progress, or time entries. At the presentation level, ask whether the view answers the original question. If you were looking for overdue tasks, a pie chart of statuses may be accurate but useless. If you wanted to show how costs are distributed, a table without totals may be accurate but awkward to discuss.

Before sending a report to a client or manager, check permissions and included columns. An export makes it harder to remove unwanted information after sharing, so internal notes, costs, and bugs should go only to the people who need them. For an external report, it’s safer to create a separate, repeatable view with only the necessary fields than to export an internal report and edit it by hand every time.

Verify the report: Reapply the same filters a few minutes later and make sure the report changes only if the source records in UpStream have changed. This is a simple way to catch a filter that wasn’t saved, a changed date range, or the wrong report type.

Using Reporting With Other UpStream Add-Ons

The clearest combination is Reporting with Time Tracking and Budgeting. The first add-on analyzes data; the second provides time, budget, and actual amount entries. A safe setup order is to agree on where entries are created and who corrects them, enter a few meaningful values in a test project, then build a report and check it against the source records. The likely conflict is usually methodological rather than technical: people may have different ideas about what counts as work time. To roll back, temporarily exclude questionable metrics from recurring reports, correct the time-tracking rule, and resume reporting after a check.

Another useful combination is Reporting with Custom Fields. Custom fields create useful segments for analysis, but they shouldn’t multiply without a purpose. First, define a question that standard fields can’t answer. Then create a limited set of values and add them to test records. Once you’ve checked the filter, apply the rule to the rest of your projects. If a field stops being useful, don’t delete it before reviewing historical reports. It may be safer to keep its existing values for reference while no longer requiring it on new records.

UpStream Reporting Troubleshooting: Diagnose Empty or Unexpected Reports

Most reporting problems can be solved without reinstalling the add-on by checking the boundaries of the data slice in order. First, confirm that the source record exists and has the expected values. Then reduce the number of filters, check the selected record type, and only after that investigate whether another add-on or cache is involved. This approach protects your data and avoids introducing new variables during troubleshooting.

The Report Is Empty Even Though the Record Exists

Symptom: After you apply filters, the table or chart has no rows, even though you can open the task or project in UpStream. Likely cause: One of the combined filters excludes the record: the date range, status, assignee, numeric limit, or custom field value. You may also have selected a report for a different record type. For example, the task exists, but you’re viewing a project report with a filter for a value that hasn’t been set on the project.

What to check: Remove every filter except the record selection and find it in the broader list. Then add filters one at a time, noting when the record disappears. Check the date format and range, the selected status, and whether the assignee is set on the specific record type you’re analyzing. For a custom field, check the exact value on the record rather than relying on a similar-looking label.

How to fix it: Adjust the filter or source record to match the actual process rule. Don’t fill a missing value with something arbitrary just to make the record appear. When to roll back: If the new filters are too narrow and you can’t explain why they’re needed, return to the last clear data slice and restate the question.

The Team Doesn’t Trust the Numbers in the Chart

Symptom: A pie or bar chart looks convincing, but people in the meeting say the breakdown doesn’t reflect the work. Likely cause: The chart is accurately aggregating inconsistent source data. This can happen when people interpret statuses differently, fail to update progress, leave tasks unlinked to milestones, or enter time late.

What to check: Switch to a table with the same filters and open several of the largest records. Compare their dates, assignees, progress, notes, and time entries. Check whether a timer was left running or whether one task combines unrelated types of work. Compare the chart with the source record, not with someone’s recollection.

How to fix it: Correct confirmed source-data errors, clarify which fields are required, and rerun the report. If necessary, share only the validation table until the team’s data entry is consistent. When to roll back: If there’s no shared rule for filling in a field, stop using it in recurring charts until the team agrees on a set of values.

The Time Filter Shows Unexpectedly High Values

Symptom: One task or bug accounts for a disproportionate share of the recorded time. Likely cause: A timer was started and stopped long after the work ended, time was entered in the wrong unit, or the entry was assigned to the wrong record. A timer tracks elapsed hours, not just working hours, so it shouldn’t be left running unattended.

What to check: Open the time entries for the specific task or bug. Compare the date, user, duration, and note with the actual work. Confirm that the Reporting filter uses hours. Check the workday setting only as a display option; it won’t correct a duration that was already entered.

How to fix it: Correct the inaccurate source entry according to your process. If your team’s practice calls for it, leave a clear explanation of the change in the project record. Then rerun the report with the same filters. When to roll back: If the team can’t maintain reliable time entries, don’t use time or amounts as the basis for a client-facing conclusion. Stick to reports on deadlines, statuses, and open bugs.

The Client Can See Too Much or Can’t See What They Need

Symptom: When you check the report under a client role, it exposes internal information or leaves out a project the client should see. Likely cause: UpStream’s access settings, the user’s client association, record visibility, and expectations for the report don’t match. Reporting shouldn’t be used to bypass access restrictions; it works with the data and permissions available to that user.

What to check: Sign in with a test account that has the same client association and permissions as the intended recipient. Open the relevant project, check which fields are visible, and then test the report. For a complex access model, first document which records and fields each role should see, then configure UpStream and, if needed, the advanced permissions add-on.

How to fix it: Adjust permissions and repeat the test on a copy of the site or with a separate test account. Don’t solve the problem by hiding a column in an exported file if the access settings themselves are still wrong. When to roll back: If the new rule prevents the team from doing its work, restore the previous model and refine access for a specific field or record instead of granting everyone broader permissions.

The Report Looks the Same After a Status or Data Change

Symptom: The record has been updated, but the report still shows the old data. Likely cause: You may have a different report open, a different date range applied, a page that hasn’t been refreshed, or a cache that’s holding the view longer than expected. First, rule out the simple causes by comparing the report title, record type, and active fields with the filters you expect.

What to check: Refresh the report page normally, reapply the filters, and compare one specific record. If the report appears on the public-facing site and caching is enabled, test it temporarily with an authorized test account or a safe, administrator-approved exception for that page. Don’t clear the entire live site cache without a reason.

How to fix it: Correct the report conditions or the targeted cache exclusion if you confirm that caching is the cause. When to roll back: If the exclusion hurts performance or exposes a public page that doesn’t need to be available, restore the previous caching setup and generate the report through an internal admin workflow.

UpStream Reporting troubleshooting map for empty reports, incorrect numbers, time entries, and access
This conceptual troubleshooting map guides you through checking the record type, filters, source entries, permissions, and cache without reinstalling add-ons at random.

Common Questions About Setting Up Reports

Do I Need UpStream Reporting If a Task List Is Enough?

Not always. A regular task list is still the best tool for day-to-day work, especially when an assignee needs to open the next task and update its status. Reporting is useful when the question goes beyond one list: you need to compare several projects, combine filters, view data in a calendar, table, chart, or timeline, or prepare a print-ready or exportable report. Don’t install the add-on just to get a chart. First, check whether you have a recurring question that a regular list answers too slowly or imprecisely.

A good sign that you need reporting is when a manager manually gathers the same information from several project pages every week: who’s busy, what’s due soon, which bugs are open, and how time is distributed. If you can define and repeat the filters for that manual review, they may belong in a report. But if the request is a one-off and depends on a lot of context from conversations, a report will be a starting point, not a substitute for reviewing the records.

Why Doesn’t a Task Appear After I Filter by Assignee?

First, make sure the assignee is set on the task itself, not just on its project or milestone. Then remove the other conditions, find the task in a broad report, and add filters one at a time. Common causes include a date range, status, progress range, different project, custom field, or wrong report type. Don’t start by reinstalling the add-on; that won’t explain why the report filters exclude a specific record.

If the task should be visible to a client, check it separately under a test client account. Report filters and access to a record are different things. The right filter can’t restore access if the role isn’t allowed to see the project or field. And broad permissions shouldn’t rely on the hope that a user won’t think to change a filter.

Can I Build Reports From Custom Fields?

Yes. Reporting supports filters that include custom fields, and the Custom Fields add-on lets you add information to projects, milestones, tasks, bugs, and files. The field must be on the record type you’re analyzing, and it must be filled in consistently. For recurring filters, lists, categories, or labels are usually a better fit than free text with several spellings.

Before adding a field to a regular report, take ten real records and check whether they group as expected. If some are blank and similar values are written in different ways, don’t try to compensate with a complicated set of filters. Create a short list of allowed values first and decide how to handle historical data. It may be enough not to require the field on older projects while making it part of the process for new ones.

What’s the Difference Between Time, a Workday, and a Budget in a Report?

Time tracking refers to the actual hours recorded on tasks and bugs. The workday setting makes durations easier to view in days and hours, but it doesn’t change the underlying hours. Budget and actual amount values appear only where your team has entered them through Time Tracking and Budgeting. Time filters use hours, so don’t estimate a conversion to workdays.

For a management review, keep these questions separate. Time answers “How much time was recorded?” Budget answers “What limit or plan was entered?” Actual amount answers “What was recorded as a cost?” One metric doesn’t prove another. For example, a complex task may normally take many hours, while a low cost doesn’t mean its deadline is safe. Review these figures alongside the milestone, status, planned date, and notes on the record.

Can I Send a Report to a Client Without Cleaning It Up by Hand?

Yes, if you design a separate version of the report for external use first. Include only the projects, fields, and views the client needs to understand the work. Don’t take an internal task list with notes and costs, then manually delete rows before each send. That process is hard to repeat and can expose extra information the next time the report is updated.

Test the external report with a role that has the same permissions as the client. Confirm that milestone names, upcoming dates, status, and progress are clear, while internal details stay hidden. If you need finer control, review UpStream’s capabilities and, if necessary, the advanced permissions add-on. Document the review steps and follow them before each important report is sent.

How Often Should I Update Data for Reports to Stay Useful?

Update data at the pace of the decisions it supports. If the team has a short daily sync, update task status and progress before or during the meeting. If time is reviewed weekly, don’t leave entries until the end of the month. A project with infrequent checkpoints may need a different rhythm, but its essential fields must be current early enough for the manager to respond to a problem.

Instead of naming one “reporting owner” for everything, assign ownership of the source data. Each assignee updates their task status and progress, the project manager checks dates and milestone links, and a finance or operations team member oversees time-tracking rules if they’re used. That keeps Reporting from turning into a manual team that fixes everyone else’s records and lets it remain a quick way to check the overall picture.

What Should I Do If a Report Looks Different After a WordPress Update?

First, check the issue on a copy of the site and compare it with your test set. Open the project, task, and report, then note the specific symptom: the page won’t open, a filter is missing, rows sort incorrectly, a record is missing, or the output has changed. Then review the current release notes for core UpStream and related add-ons, as well as compatibility with the active theme and other plugins. Interface changes and fixes in a release history don’t prove that your specific combination is compatible.

Before updating, save the list of regular reports and take a few screenshots of the test results. After the update, run those same reports again instead of checking only the main page. If you find a problem, it’s safer to temporarily restore the last known-good state from a backup and report the specific symptom than to edit plugin files by hand. Changes to core or add-on files make future updates harder and aren’t a normal way to configure Reporting.

Does Reporting Affect Public-Site Performance or SEO?

Reporting isn’t an SEO tool, and it shouldn’t be used to create indexable pages containing internal project data. Performance depends on where the report is displayed, how many records it includes, which other plugins are active, and how caching is configured. For internal reporting, it makes sense to create reports in the admin area or on protected pages instead of publishing large reports without a clear need.

If a client needs an external report, limit the fields and date range, use a clear, protected access path, and test the page as an authenticated user. Don’t add sitewide cache exclusions for a single report. Start with a targeted check, measure the actual effect, and keep only changes that address a confirmed problem. This approach helps preserve privacy and makes ongoing maintenance more predictable.

A Reporting Habit That Pays Off Month After Month

Over time, Reporting’s value comes from asking the same question and taking action on the answer, not from saving more charts. Choose a small set of recurring reports: upcoming task risks, open bugs by severity, project status overview, and time by task where tracking is reliable. For each one, write a single line explaining who runs it, when, what decision it supports, and which fields the team must update first. That short instruction is often enough to keep the report from depending on one person.

Every few weeks, review the report’s usefulness, not its design. If a report no longer leads to action, remove it from the regular meeting. If people keep asking for manual clarification, look for a missing field or unclear status. If a chart prompts disagreement, return to the rows and check the source data. UpStream Reporting works like a mirror for the process: it won’t make the process mature by itself, but it can quickly show where data-entry rules, access, or work structure need attention.

When UpStream Reporting Is a Good Fit

This add-on is a good fit for a WordPress site where core UpStream is already part of the team’s project workflow. It helps turn project, milestone, task, and bug data into repeatable reports, from review tables to calendars, charts, and timelines. Teams get the most value when they agree on statuses, dates, assignees, and custom fields first, then use reports to check decisions instead of treating them as a showcase.

Before using it on a live site, run a short test: choose one project, create a test set, build a simple report, compare it with the source records, and only then add narrower filters, exports, or external views. If this process gives you a clear answer to a real question, you can download the latest version of UpStream Reporting and roll it out gradually, keeping a way to reverse configuration changes and check access permissions.

Don’t try to cover all of the organization’s work with one report. Let each report do one thing well: show deadlines, time distribution, open issues, or portfolio status. When the source data is kept up to date, that simple discipline makes reports more useful than a complex dashboard and helps the team spot problems before they become unpleasant surprises for clients.

By OceanTheme.org Editorial Team

 

You are not logged in to post comments.