instance method `deliver_later`

Ruby on Rails 8.0.4

Since v4.2.9

Available in: v4.2.9 v5.2.8.1 v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Compare with:

deliver_later(options = {})

Enqueues the email to be delivered through Active Job. When the job runs it will send the email using deliver_now.

Notifier.welcome(User.first).deliver_later
Notifier.welcome(User.first).deliver_later(wait: 1.hour)
Notifier.welcome(User.first).deliver_later(wait_until: 10.hours.from_now)
Notifier.welcome(User.first).deliver_later(priority: 10)

Options:

:wait - Enqueue the email to be delivered with a delay.
:wait_until - Enqueue the email to be delivered at (after) a specific date / time.
:queue - Enqueue the email on the specified queue.
:priority - Enqueues the email with the specified priority

By default, the email will be enqueued using ActionMailer::MailDeliveryJob on the default queue. Mailer classes can customize the queue name used for the default job by assigning a deliver_later_queue_name class variable, or provide a custom job by assigning a delivery_job. When a custom job is used, it controls the queue name.

class AccountRegistrationMailer < ApplicationMailer
  self.delivery_job = RegistrationDeliveryJob
end

Parameters

options opt = {}

Source

# File actionmailer/lib/action_mailer/message_delivery.rb, line 102
    def deliver_later(options = {})
      enqueue_delivery :deliver_now, options
    end

Defined in actionmailer/lib/action_mailer/message_delivery.rb line 102 · View on GitHub · Improve this page · Find usages on GitHub

Defined in ActionMailer::MessageDelivery

Signature

Parameters