User guideBuilding
Scheduled re-renders and report delivery
Refresh a published document on a schedule, and email a link to the people who read it.
A document app shows the numbers from its last render. A render schedule re-renders it on a cron expression.
Set a schedule
Section titled “Set a schedule”- Open the app’s Settings tab.
- Under Re-render on a schedule, enter a five-field cron expression, in
UTC.
0 6 * * 1-5is 06:00 UTC on weekdays. - Select Schedule. The On switch pauses it; Remove deletes it.
A re-render is a full deploy of the app’s branch: the code is fetched again, dependencies are reinstalled, and the document runs from the top. It appears in the app’s deployment history. If it fails, the published version stays up.
Send it to people
Section titled “Send it to people”Once a schedule exists, add recipients under Send it to. After each successful scheduled render, each recipient gets an email with a link to the app.
- A link, never the file. Recipients sign in as usual, so a private report stays private, and everyone on the list needs access to the app.
- Only a scheduled render sends. A failed render or a manual redeploy mails nobody.
- Access is re-checked on every send. Someone who has lost access, or has no email address, is skipped with a reason and stays on the list.
- Sends are rate-limited. A render that comes too soon after the last delivery is recorded as skipped.
- Mail must be configured. Without a mail relay on the install, every recipient is skipped with that reason.
The latest delivery result is shown beside the recipient list.
Render schedule vs. a scheduled job
Section titled “Render schedule vs. a scheduled job”A render schedule rebuilds and republishes a document. A job with a schedule runs a command from your deployment and leaves the published document as it is. Use a render schedule to refresh what readers see; use a job for work alongside it.