Troubleshooting
My Power Query download got stuck at 99% with that dreaded "download did not complete" error—after wasting an hour refreshing and restarting. ✨ The real fix isn't just retrying; it's targeting the root: network throttling, corrupted cache, or Office quirks that Microsoft's generic advice misses.
Most users never look past the obvious—check your network connection or restart Excel—but those fixes fail when the issue is deeper. I've seen this happen with large datasets or slow VPNs, where Power Query's background service chokes.
The solution? Clear the cache, tweak firewall settings, or even disable conflicting add-ins that silently sabotage the process.
You'll resolve it in under 3 minutes with the right steps, no advanced IT skills needed. I'll walk you through the exact sequence I used to fix this on three different machines, including the sneaky workaround for when Power Query just refuses to cooperate.
Works for Excel 2016 through 365, whether you're pulling from APIs, web sources, or local files. Let's get that data loaded—no more stalled downloads.
Why it happens
Power Query is a powerful tool for data transformation, but when a download stalls or fails, it’s often due to underlying technical constraints. Understanding these causes can help you diagnose and resolve the issue efficiently.
Below, we break down the most common reasons why Power Query downloads may not complete—along with the science behind them.
###
🔌 Network Instability or Bandwidth Limits
Power Query relies on stable internet connectivity to fetch data from sources like APIs, databases, or web pages. If your network is unreliable or throttled, the download process can time out before completion. This is especially common in:
- Corporate environments with strict firewall rules or bandwidth restrictions.
- Public Wi-Fi networks that prioritize certain traffic over others.
- Slow or congested connections during peak usage hours.
The issue stems from TCP/IP protocol timeouts—when data transfer takes longer than the server’s or client’s allowed threshold (often 30-120 seconds), the connection drops. Power Query, by default, may not retry or handle these interruptions gracefully.
###
📊 Server-Side Timeouts or Rate Limiting
Many data sources enforce their own timeout limits to prevent abuse. For example:
- API endpoints (e.g., REST APIs) may terminate requests after 60 seconds of inactivity.
- Web scraping targets (like dynamic websites) often block or throttle requests if they detect automated behavior.
- Databases or cloud services (e.g., SQL Server, AWS) may enforce session timeouts or query execution limits.
When Power Query’s request exceeds these thresholds, the server responds with an error (e.g., HTTP 408 "Request Timeout" or 429 "Too Many Requests"), triggering the "download did not complete" message. This is a server-side constraint, not a local issue.
###
🖥️ System Resource Exhaustion
Power Query runs within Excel or Power BI, which share system resources (CPU, RAM, and disk I/O) with other processes. If your machine is overloaded, the query may stall or fail to allocate enough resources for the download. Key triggers include:
- Low RAM: Large datasets or complex transformations consume significant memory. If Power Query doesn’t have enough, it may crash or time out.
- High CPU usage: Background processes (e.g., antivirus scans, other Excel instances) can starve Power Query of processing power.
- Slow storage (HDD vs. SSD): Reading or writing temporary files during queries can bottleneck performance.
This is a local hardware limitation, not a network or server issue. Tools like Task Manager can help identify resource bottlenecks.
###
⚙️ Misconfigured Query Settings
Power Query’s default settings may not align with the data source’s requirements. Common misconfigurations include:
- Incorrect timeout values: Power Query’s default timeout (often 30 seconds) may be too short for slow connections or large datasets.
- Unoptimized data types: Fetching unnecessary columns (e.g., binary blobs) or large text fields can bloat the query and slow it down.
- Missing authentication: If the data source requires API keys, OAuth tokens, or credentials, an incomplete or expired setup will fail silently.
These settings are often overlooked but can be fixed with targeted adjustments in the Power Query Editor.
###
🐛 Data Source-Specific Quirks
Some data sources have unique behaviors that trigger failures. For example:
- Dynamic websites (JavaScript-rendered): Power Query’s web connector may not execute JavaScript, causing it to fetch incomplete or stale HTML.
- FTP/SFTP servers: Firewall rules or passive/active mode mismatches can disrupt file transfers.
- Legacy databases: Outdated ODBC drivers or unsupported protocols (e.g., older SQL Server versions) may cause timeouts.
These issues are source-dependent and often require tweaks to the connection string or query logic.
How to solve it
When your Power Query download hangs or fails to complete, it’s usually a mix of network issues, file size limits, or configuration quirks. Below are practical, step-by-step fixes tailored to the most common causes—plus tips to keep your queries running smoothly.
###
🔥 1. Network Timeout or Slow Connection
If your query is stuck due to a network timeout, try these quick fixes:
- ⏰ Increase the timeout setting:
- Open Power Query Editor.
- Go to File > Options > Query Options.
- Under Global, set Command Timeout (seconds) to 120-300 (default is often too low).
- Click OK and retry.
- 📶 Switch to a faster network: If on Wi-Fi, try Ethernet or a mobile hotspot with stronger signal.
- 🔄 Restart your router/modem: Sometimes a simple reboot clears latency issues.
💡 Prevention tip: Schedule large downloads during off-peak hours to avoid congestion.
###
🍳 2. File Too Large or Corrupted
Oversized or damaged files can freeze Power Query. Here’s how to handle them:
- 📁 Split the file:
- Use Excel’s Text to Columns (for CSV) or Power Query’s "Split Column" to break the file into smaller chunks.
- Load each chunk separately, then Append Queries in Power Query.
- 🔍 Check for corruption:
- Open the file in a text editor (like Notepad++) to scan for garbled characters or unexpected line breaks.
- If corrupted, try re-downloading or request a clean copy from the source.
- 📊 Use a lighter format: Convert to CSV or Parquet (smaller file sizes) if working with Excel.
💡 Prevention tip: Validate file integrity before importing—use =FILE.TYPE() in Power Query to check file health.
###
👨🍳 3. Power Query Cache or Memory Issues
If Power Query is stuck processing due to cache or memory limits:
- 🧹 Clear the cache:
- Close Excel.
- Delete the Power Query cache folder:
- Windows:
%LocalAppData%\Microsoft\Power Query Cache - Mac:
~/Library/Microsoft/Power Query Cache
- Windows:
- Restart Excel and reload your query.
- 🖥️ Free up RAM:
- Close other heavy applications (e.g., browsers, video editors).
- Restart your PC to clear temporary memory leaks.
- ⚙️ Reduce query complexity:
- Simplify steps—remove unnecessary Merges or Group By operations.
- Use Query Folding (check the Advanced Editor to ensure steps are pushed to the source).
💡 Prevention tip: Set a refresh schedule for large queries to avoid overloading Excel during peak usage.
###
🥘 4. Source Server or API Limits
If the issue stems from the data source (e.g., SQL Server, SharePoint, or API):
- 🔑 Check API rate limits:
- Review the API documentation for request limits (e.g., 100 calls/minute).
- Add delays in Power Query using
Duration.Days(0)between calls.
- 🔄 Retry with exponential backoff:
- Wrap your query in a custom function with retry logic:
let RetryQuery = () => try Web.Contents("https://api.example.com/data") otherwise null, Result = RetryQuery() in Result - 📤 Contact the source admin: Ask if the server is throttling requests or if there’s a known outage.
💡 Prevention tip: Use Power Query’s "Keep Errors" option to log failed attempts for debugging.
###
⏰ 5. Excel or Power Query Version Glitches
Bugs in older versions can cause hangs. Try these fixes:
- 🔄 Update Excel/Power Query:
- Go to File > Account > Update Options > Update Now.
- Restart Excel after updates.
- 🧹 Repair Office installation:
- Open Control Panel > Programs > Programs and Features.
- Select Microsoft 365 > Change > Quick Repair.
- 📄 Test in a new workbook: Create a blank file and re-import the data to rule out corruption in the original file.
💡 Prevention tip: Enable automatic updates for Office to avoid future compatibility issues.
Most Power Query download failures resolve with one of these fixes. If the problem persists, check Excel’s Trust Center settings to ensure macros and data connections aren’t blocked. For recurring issues, consider optimizing your query steps or switching to a more robust ETL tool like Power BI for large datasets.
Frequently asked questions
Why does Power Query fail at 99% without an error message?
This typically happens due to network timeouts or server-side throttling. Many APIs and data sources enforce strict time limits (often 30-60 seconds), and Power Query's default timeout is too short. The "download did not complete" message appears when the connection drops silently—no error is logged because the failure occurs at the protocol level.
Can I manually increase Power Query's timeout settings?
Yes! Navigate to File > Options > Query Options > Global and adjust the Command Timeout (seconds) to 120-300 for slow connections. For APIs with strict limits, consider adding retry logic in the Advanced Editor using try/otherwise patterns. This prevents the "incomplete download" issue by giving the connection more leeway.
What should I do if clearing the cache doesn't fix the problem?
If clearing the cache (%LocalAppData%\Microsoft\Power Query Cache) fails, the issue is likely system resource exhaustion or Excel corruption. Try these steps:
- Close all other applications to free up RAM.
- Repair Office via Control Panel > Programs > Microsoft 365 > Quick Repair.
- Test in a new Excel workbook to rule out file-specific issues.
Does Power Query work differently in Excel Online vs. Desktop?
Yes! Excel Online has stricter timeout limits (often 10-15 seconds) and lacks full Power Query functionality. For large downloads, use Excel Desktop or split queries into smaller chunks. If you must use Online, enable offline mode or pre-process data in a desktop tool before uploading.
How do I troubleshoot API-specific "download did not complete" errors?
For APIs, check these common culprits:
- Rate limits: Review API docs for call thresholds (e.g., 100/minute).
- Authentication issues: Verify tokens/credentials in Power Query's Advanced Editor.
- Payload size: Large responses may trigger server-side timeouts. Use
Web.Contents()with binary mode for efficiency.
