How to build a document engagement heatmap in HubSpot

Every rep on your team has an opinion about the best time to send a proposal. Some swear by Tuesday mornings. Others insist Friday afternoons are fine because buyers review documents over the weekend. The truth is, most of those opinions come from gut feel, not data.

A document engagement heatmap turns that guesswork into a clear visual answer. It shows you exactly when your buyers are opening and reviewing the documents you send, broken down by day of the week and time of day. And because Portant saves document engagement data directly to HubSpot, you can build one using properties you already have.

I work with HubSpot teams on reporting and data quality, and this is one of the reports I recommend most often. It takes about ten minutes to set up, and the insights usually surprise people.

Why send timing shapes proposal outcomes

When you send a proposal matters more than most teams realize. A proposal that hits someone's inbox at 9am on a Tuesday might get opened within the hour. The same proposal sent at 4pm on a Friday might sit unread until Monday, and by then the buyer has three other things competing for attention.

I see this pattern in CRM data all the time. Two reps on the same team, selling the same product, with similar deal sizes, but very different response rates. When I look at the engagement timeline, the difference usually comes down to when the document landed. Not the quality of the proposal. Not the relationship. Just timing.

The tricky part is that "the best time" varies by buyer. What works for one persona or industry might be completely wrong for another. A construction procurement team keeps different hours than a SaaS startup's VP of Engineering. That's why you need your own engagement data, not generic advice from an email marketing blog.

What a document engagement heatmap actually shows you

A document engagement heatmap is a time-based grid that maps when your documents are being viewed. The vertical axis lists days of the week, Monday through Sunday. The horizontal axis breaks each day into time blocks, usually by hour or by broader windows like morning, afternoon, and evening. Each cell shows the number of document views in that window.

The cells with the highest view counts create a visual pattern. At a glance, you can see that your buyers tend to review proposals on Tuesday and Wednesday mornings, or that there's a consistent spike on Sunday evenings.

This is different from email open tracking. An email open tells you someone clicked a message. A document view tells you someone actually sat down with your proposal, quote, or contract. That's a stronger buying signal, because reviewing a multi-page document takes deliberate attention.

The heatmap gives you two things. First, it tells you when buyers are most receptive, so you can time your sends to match. Second, it reveals engagement windows you probably didn't know existed, like weekend review sessions or early morning reading habits.

The Portant document properties that power this report

Every time Portant generates a document from HubSpot, it creates a Document record with several engagement properties. Three of these are essential for the heatmap.

• Date Last Viewed: the timestamp of the most recent time someone opened the document. This is the primary field for your heatmap report. Each timestamp gives you both the day and the hour.
• Number of Times Viewed: a running count of total views. Useful for filtering out documents that were never opened, so they don't skew your quiet time slots.
• Document Created: when Portant generated the document. Comparing this with Date Last Viewed tells you how quickly buyers engage after receiving a document.

These properties are added automatically when you run your first Portant workflow. You'll find them grouped under the Portant section in your HubSpot deal, contact, company, or ticket properties. For setup details, see the guide on viewing created documents in HubSpot.

You also have Portant Workflow Name, which maps to your template. This becomes important later when you want to segment the heatmap by document type.

How to build the report in HubSpot, step by step

Here is how I set this up for teams. It takes about ten minutes if your Portant properties are already populated.

Step 1: Open HubSpot's custom report builder. Go to Reports > Create Report > Custom Report Builder. Choose "Single Object" and select the Portant Document Object (or Deals, if your document properties are associated at the deal level).

Step 2: Set Date Last Viewed as your date dimension. Drag Date Last Viewed into the report. This is the field that tells you when buyers opened each document.

Step 3: Group by day of the week. On one axis (I usually use the vertical), group Date Last Viewed by day of the week. HubSpot's report builder lets you extract the day name from a date property.

Step 4: Group by time of day on the second axis. On the horizontal axis, group by the hour or by a custom time bucket (morning, afternoon, evening). If HubSpot's builder gives you hourly granularity, use it. You can always consolidate later.

Step 5: Set your measure to count. Count the total number of records (document views) for each cell. This is what creates the heatmap effect: high counts in certain cells, low counts in others.

Step 6: Filter for viewed documents only. Add a filter so Number of Times Viewed is greater than zero. You want engagement data, not a count of documents that were never opened.

Step 7: Set a date range. I recommend starting with the last 90 days. That gives you enough volume to see patterns without mixing in seasonal changes. If your team sends a high volume of documents, 30 days may be enough.

Save the report to a dashboard where your team reviews pipeline performance. The heatmap is most useful when it's visible in weekly pipeline reviews, not buried in a report folder.

Reading the heatmap: what the patterns mean

Once the report is built, the interesting part starts. Here's what I look for.

Hot zones. These are the cells with the highest view counts. They tell you when buyers are most likely to sit down with your documents. For many B2B teams, hot zones cluster between Tuesday and Thursday, mid-morning (9am to 11am). But your data may tell a completely different story.

Cold zones. Low or zero-count cells show you when sending is likely a waste. If Friday afternoon is consistently empty, that's a signal to avoid sending proposals late in the week. Documents sent into cold zones often get buried under weekend email and lose their urgency by Monday.

Off-hours spikes. Keep an eye on early morning (6am to 8am) and evening (7pm to 10pm) activity. These windows often represent senior decision-makers who review documents before or after their meeting-heavy days. If you see consistent off-hours engagement, it might change how you think about "business hours" for your buyers.

Weekend patterns. Some teams see meaningful Sunday evening activity, especially in industries where executives use quiet weekend time to catch up on deal paperwork. If your heatmap shows Sunday engagement, you might want to send documents on Friday morning so they're sitting in the inbox when that Sunday review session happens.

Day-of-week totals. Look at the row totals, meaning total views per day regardless of time. If Monday is consistently the highest day, your buyers are starting their week by reviewing open proposals. That suggests sending late Friday or early Monday to ride that wave.

Segmenting your heatmap for sharper insights

The overall heatmap is useful, but the real insights come when you segment.

By document type (Portant Workflow Name). Quotes, proposals, and contracts often have different engagement patterns. A quick quote might get opened the same day. A detailed proposal might sit for 48 hours before the buyer carves out review time. A contract might get opened multiple times as the buyer loops in legal. Filtering by Portant Workflow Name lets you see these differences and adjust your timing for each document type.

By deal stage. Early-stage documents (initial quotes, ballpark estimates) might get opened at different times than late-stage documents (contracts, statements of work). If you notice that contract reviews happen more often in the evening, that could mean legal teams are doing their review after hours.

By deal owner. This one is revealing. If one rep's documents get viewed more consistently than another's, it might not be the documents themselves. It might be send timing. Comparing heatmaps across reps can surface coaching opportunities without anyone feeling singled out.

By industry or company size. If your team sells across multiple verticals, expect different engagement patterns. Financial services buyers might review documents early morning before markets open. Healthcare administrators might have afternoon windows after clinical hours. If you have enough volume, segment by a company property like Industry and compare the heatmaps side by side.

From heatmap to action: adjusting your send timing

The heatmap tells you when buyers read. The next step is matching your send timing to those windows.

The principle is straightforward: send documents so they arrive just before or at the start of a hot zone. If your heatmap shows peak engagement at 10am on Wednesdays, sending at 9:30am on Wednesday puts your proposal at the top of the inbox right when the buyer is most likely to open it.

Here are some practical adjustments I've seen teams make.

Shift sends from Friday afternoon to Thursday morning. If the heatmap shows Friday is a cold zone, moving the send earlier in the week means the document gets attention before the weekend, not after.

Schedule sends for time zones. If your buyers are in a different time zone, adjust for their local hot zone, not yours. A 10am EST send hits a West Coast buyer at 7am, which might land in a hot zone or miss entirely depending on the data.

Send contracts before the off-hours window. If you see evening review patterns for contracts, send them by mid-afternoon. The buyer will open them during their evening review session when they have fewer distractions and more time to read carefully.

Avoid sending into known cold zones. This sounds obvious, but it's the adjustment with the biggest payoff. If Monday afternoon is dead in your heatmap, stop sending proposals on Monday afternoon. It's one of the easiest behavioural shifts a team can make, and the results show up in open rates quickly.

One thing to watch: don't over-optimize for a single time slot. If you have the entire team sending proposals at 10am on Tuesday, you'll flood the same inbox window. Spread across the hot zone rather than piling into one hour.

The connection between send timing and time-to-sign

Send timing doesn't just affect whether a document gets opened. It affects how long it takes to get signed.

When a proposal arrives during a hot zone, the buyer is already in document-review mode. They read it, share it internally, and the decision process starts while interest is fresh. When the same proposal arrives during a cold zone, it waits. Every day it sits unread, urgency fades and competing priorities creep in.

I've seen this in the data consistently. Documents opened within the first four hours of being sent tend to reach signature faster than documents that sit for two or more days before the first view. The gap is usually several days' difference in average time-to-sign.

This connects to how you set up your Portant HubSpot integration. If you're using Portant to automate document generation from deal stage changes, you can also consider when those workflows fire. Rather than generating and sending a proposal the instant a deal enters a stage, you could add a short delay so the document goes out during your highest-engagement window.

The goal isn't to delay deals. It's to give each document the best chance of being read and acted on quickly.

Common surprises teams find in their first heatmap

After building heatmaps with dozens of teams, here are the patterns that consistently catch people off guard.

Early morning engagement is real. Many teams assume business hours means 9am to 5pm. But I regularly see a cluster of views between 6:30am and 8am. These are often senior buyers or decision-makers who review proposals before their calendar fills up. If you're only sending documents mid-morning, you're missing this window.

Sunday evening is a thing. For B2B teams selling to mid-market and enterprise buyers, Sunday 7pm to 10pm is often a quiet but consistent engagement window. Executives use this time to get ahead of Monday. If your data confirms this, sending on Friday morning gives the document time to arrive and sit ready for that Sunday session.

Lunch hours aren't always dead. Some teams see a dip from 12pm to 1pm, but others see a spike. It depends on the buyer persona. Individual contributors might use lunch to catch up on inbox items. Buyers who spend all day in meetings might use lunch as their only quiet reading time.

Wednesday is often the strongest day. Not Tuesday, which is the popular wisdom. In many B2B datasets, Wednesday morning is the peak engagement window. Buyers have cleared their Monday and Tuesday backlog and finally have time to sit with longer documents.

Cold zones are more consistent than hot zones. While peak engagement times shift seasonally or by deal type, the times when nobody opens documents tend to stay remarkably stable. Knowing your dead zones with confidence is just as valuable as knowing your peak zones.

Frequently asked questions

How much data do I need before the heatmap is useful?

I recommend at least 50 viewed documents over a 30 to 90 day window. Below that threshold, one or two outliers can distort the pattern. If your team is smaller, extend the date range to capture more data. The patterns usually stabilize once you have a few months of engagement history.

Can I build this with HubSpot Starter, or do I need Professional?

Custom reporting on Portant's Document Object properties requires HubSpot Professional or Enterprise. Starter plans have limited custom report access. If you're on Starter, you can still export the data and build the heatmap in a spreadsheet, but the live dashboard experience is much more useful for ongoing optimization.

Should I look at Date Last Viewed or Document Created for the heatmap?

Use Date Last Viewed. That's when the buyer actually opened the document, which is the engagement signal you care about. Document Created tells you when the document was generated, which is useful for measuring response time, but it doesn't tell you about buyer behaviour patterns.

What if my heatmap looks completely flat with no clear pattern?

A flat heatmap usually means one of two things. Either your sample size is too small and you need more data, or your team is sending documents at random times, which creates even distribution. In the second case, the heatmap is telling you something useful: your team has no consistent send timing, which is itself the problem to fix. Start by consolidating sends into two or three time windows and measure again after 30 days.