Common download and editor failures.
Dataset download issues
What fails?
Check Firebase and ATP
Confirm the visitor is signed in so X-PRC-User-Id and X-PRC-User-Token are sent. For ATP datasets, accept terms via check-atp / accept-atp. HTTP 429 means IP rate limiting on get-download.
Check attachment and caps
Ensure _download_attachment_id is set in Dataset Options. download-stats requires edit_posts. Use wp prc datasets missing-files to find datasets without attachments.
This answer needs a valid destination.
Edit the block and connect this answer to another question or outcome.
Front-end download returns an error
- Missing or invalid Firebase headers → identity check fails
- ATP dataset without acceptance → complete the legal acceptance block first
- Rate limited → wait and retry; limit is enforced per IP on
get-download
Download unavailable / empty file
When resolve fails, public get-download stamps _download_unavailable. Filter those rows in Datasets > All Datasets with the Download filter (downloadUnavailable=1). Attach a ZIP in Dataset Options to clear the flag, or confirm _download_attachment_id / dataset_download_url is set. Use wp prc datasets missing-files to find datasets without attachments.
Stats look wrong after a file replace
Editors must confirm the new-data upload modal so new_data_uploaded is set. The sidebar heatmap can split that month into before/after counts. Cached stats expire after 24 hours or on meta invalidation.