Skip to main content

Scheduled Jobs


We’re currently making rapid changes to the product so our docs may be out of date. If you need help, please email

As in the Technical Overview, We use Heroku Scheduler for scheduled jobs. As the name suggests, this is for regularly recurring tasks that need to be run every day, week, month, year, decade, and century.

Tasks are implemented in forem/lib/tasks/fetch.rake, typically in the form of:

task some_unique_task_name:, [optional_arg] => :environment do |optional_arg|
... do your thing here ...

You can explore the official Heroku documentation for defining tasks and read through tasks we have implemented for busting cache, awarding badges, and more.

In your Pull Request, communicate with a Forem Core Team Member to discuss at what frequency and ensure your task is scheduled on Heroku once your code is reviewed, approved, and merged.