HomeDocumentationGravity Forms Email BlacklistDeveloper Resources: Gravity Forms Email Blacklist

Developer Resources: Gravity Forms Email Blacklist

Filter: gf_blacklist_validation_message

This filter lets you customize the error message shown to users if their email is blacklisted based on form or field settings.

Parameters

  • $validation_message (string): The error message to display.
  • $field (object): The Gravity Forms field object.
  • $email (string): The full email address being validated.
  • $domain (string): The domain part of the email address.
  • $tld (string): The top-level domain (TLD) of the email address.
  • $blacklist (string): A comma-separated list of blacklisted emails.

Returns

(string): The error message displayed when the email is blacklisted.


Filter: gf_blacklist_is_valid

This filter lets you determine whether an email passes blacklist validation during form submission.

Parameters

  • $is_valid (bool): Indicates if the email passes validation (default: FALSE).
  • $field (object): The Gravity Forms field object.
  • $email (string): The full email address being validated.
  • $domain (string): The domain part of the email address.
  • $tld (string): The top-level domain (TLD) of the email address.
  • $blacklist (string): A comma-separated list of blacklisted emails.

Returns

(bool): TRUE if the email is valid and not blacklisted; FALSE otherwise.


Filter: gf_blacklist_is_spam

This filter lets you determine if a form entry should be flagged as spam based on email validation.

Parameters

  • $is_valid (bool): Indicates if the email passes spam validation (default: FALSE).
  • $field (object): The Gravity Forms field object.
  • $email (string): The full email address being validated.
  • $domain (string): The domain part of the email address.
  • $tld (string): The top-level domain (TLD) of the email address.
  • $blacklist (string): A comma-separated list of blacklisted emails.

Returns

(bool): TRUE if the email is valid and not flagged as spam; FALSE otherwise.


Filter: gf_blacklist_validation_short_circuit

This filter lets you bypass the email blacklist validation process entirely for specific cases.

Parameters

  • $skip (bool): Set to TRUE to skip blacklist validation (default: FALSE).
  • $field (object): The Gravity Forms field object.
  • $email (string): The full email address being validated.
  • $domain (string): The domain part of the email address.
  • $tld (string): The top-level domain (TLD) of the email address.
  • $blacklist (string): A comma-separated list of blacklisted emails.

Returns

(bool): FALSE if the validation process was not skipped.

We use cookies to offer you a better browsing experience, analyze site traffic, and personalize content. Read about how we use cookies and how you can control them in our Privacy Policy. If you continue to use this site, you consent to our use of cookies.