instance method `deliver_later!`

Ruby on Rails 7.2.3

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!. That means that the message will be sent bypassing checking perform_deliveries and raise_delivery_errors, so use with caution.

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 75
    def deliver_later!(options = {})
      enqueue_delivery :deliver_now!, options
    end

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

Defined in ActionMailer::MessageDelivery

Signature

Parameters