Gift email troubleshooting

Gift emails go out through your site's normal WordPress mail. The plugin records whether your mail system accepted each email. No plugin can confirm that an email reached the inbox or was opened.

A delivery problem never affects the card's value. A card with a failed email still holds its full balance and can be spent with its code.

Start here: send a test email

Go to Artbees → Gift Cards → Emails.
Under Test the experience, enter an address you can check in Test recipient.
Click Send a test email.

Result	What it means	What to do
"Test submitted to the email transport. It is not a redeemable card." and it arrives	Mail is working.	Check the gift email's design and content.
Submitted, but nothing arrives	Your mail system accepted it, but it was filtered or lost on the way.	Check spam. Then see Improve inbox placement.
"The email transport did not accept the test message."	WordPress couldn't send at all.	See Fix sending.

Test emails use a sample card that can't be redeemed. You can send five every few minutes.

Find gift emails that need attention

Overview → Delivery & background health counts emails that are Queued or scheduled and those that Need delivery review.
Emails → View card delivery activity opens the card list.
Each card's Delivery section lists every attempt with its Destination, Schedule / attempt, State and Attempts.

What each state means

State	Meaning
Scheduled	A Pro scheduled email waiting for its time.
Queued	Waiting for the next background run.
Sending	Being handed to the mail system now.
Submitted to mail system	Accepted by your mail system. This doesn't confirm inbox arrival.
Retry	Refused by the mail system. It's tried again automatically after a short wait.
Failed	Refused three times. It won't be tried again until you act.
Uncertain	The result couldn't be confirmed, for example because the request was interrupted.

Emails stuck in Queued or Scheduled

Emails are sent by background tasks that run on WP-Cron.

On Overview, check Last queue run. If it's old or says "Not yet", background tasks aren't running.
If you see "WP-Cron is disabled. Ensure a server cron runs WordPress scheduled tasks.", ask your host to set up a server cron that runs wp-cron.php every minute.
On low-traffic sites, WP-Cron runs only when someone visits. A server cron fixes this too.
To send due emails straight away, click Run due tasks now, or run wp gift-cards run-jobs with WP-CLI.

Fix sending

If emails are Failed or the test email isn't accepted, WordPress can't send mail.

Send a WooCommerce test or a password-reset email to see whether other site emails work.
If they don't, install and configure an SMTP or transactional email plugin from your email provider.
Send a gift test email again.
On Overview, click Retry failed fulfillment tasks, then Run due tasks now.

Improve inbox placement

If emails are Submitted but recipients don't see them:

Send through an authenticated mail service with SPF, DKIM and DMARC set up for your domain, not through the server's default mail.
Use a "from" address on your own domain.
Ask the recipient to check spam and promotions folders.
Keep the subject and heading clear and personal. The default subject is "A gift for you from {store}".

Resend a card

Open the card from WooCommerce → Gift Cards, click Resend existing card in the Delivery section, and give a reason. Resending sends the same card and value again. It never creates a new card and doesn't recall the earlier email.

If the state is Uncertain, check with the recipient first. The first email may have arrived.

If the address is wrong, don't resend. Use Correct recipient email instead. See Selling and sending gift cards.

With Pro and Purchaser self-service on, buyers can resend to the same recipient themselves from their gift page, up to three times an hour.

The customer can't wait

The customer can still use the gift right away:

Open the card, click Reveal code and share the code securely, or
Click Open secure card page and share that link.

Treat a code like cash. Anyone who has it can spend it.