Derek Hogue - Amphibian Design

3rd Party (Free)

228 downloads (last 90 days)

GNU General Public License v3

EE Version Support

  • ExpressionEngine 1.x
  • ExpressionEngine 2


If an item is crossed out, it might be untested, not applicable or incompatible. Contact the developer to be sure.

  • Updater
  • Multi Site Manager
  • Stand Alone Entry Form
  • Low Variables
  • Content Elements
  • Better Workflow
  • Matrix
  • Grid
  • Webservice
  • Publisher


  • jQuery for the Control Panel

Add-On Type(s)



Spam-Freeform runs submissions from Solspace's Freeform module through the Akismet anti-spam service.


  • ExpressionEngine 1.x or 2.1.x with Freeform installed
  • PHP 5+ and cURL support
  • An Akismet API key


After activating Spam-Freeform and adding your Akismet API key to the Extension Settings, you need to add some hidden fields to your Freeform forms. These hidden fields tell the extension which content should be sent to Akismet for screening.

  • spamfreeform_name: the field name who’s content should be used as the submitter’s name when sent to Akismet.
  • spamfreeform_email: the field name who’s content should be used as the submitter’s email address when sent to Akismet.
  • spamfreeform_fields: a pipe-delimited list of field names who’s content should be used as the submitter’s “comment” when sent to Akismet. This can be the cumulative contents of one or more fields.

If a submission is found to be spam by Akismet, the user will receive an error message indicating that their submission was deemed to be spam, and the form will not be submitted.

Any Freeform forms which don’t have the spamfreeform_fields hidden field will simply bypass Akismet screening.

Here’s an example Freeform form with Spam-Freeform fields added:

{exp:freeform:form form_name="Contact Form" notify="" required="name|email|phone|comments|how-did-you-hear" return="contact/thanks" template="contact"}        
            <label for="name">Your Full Name:</label>
            <input type="text" name="name" id="name" />
            <label for="email-address">Your Email Address:</label>
            <input type="text" name="email" id="email-address" />
            <label for="phone">Your Phone Number:</label>
            <input type="text" name="phone" id="phone" />
            <label for="comments">Comments:</label>
            <textarea name="comments" id="comments"></textarea>
            <label for="how-did-you-hear">How did you hear about us?</label>
            <textarea name="how-did-you-hear" id="how-did-you-hear"></textarea>
            <input type="submit" value="Submit" />
            <input type="hidden" name="spamfreeform_name" value="name" />
            <input type="hidden" name="spamfreeform_email" value="email" />
            <input type="hidden" name="spamfreeform_fields" value="comments|how-did-you-hear" />

Download Spam-Freeform

EE Support Downloads Add-On Version Release Date
Not Specified Download 1.0 Dec 30, 2010
Not Specified Download 1.0 Dec 30, 2010

Spam-Freeform Links

This entry was created January 3, 2011, 12:08 pm.
This entry was last updated January 3, 2011, 4:18 am.

Disclaimer: Information about ExpressionEngine add-ons is provided as a service to you, the user, and every member of the ExpressionEngine community. devot:ee is not responsible if you hose, mangle, wreck, or otherwise destroy your EE website by installing an add-on that you found out about at this site, regardless of its rating, Favorites status, commercial or free status, or general popularity. Caveat EEmptor!

Returns: devot:ee has a 30-day return policy on all commercial add-ons sold through If you need to return an add-on, do not go to the developer or the developer's site, but rather visit our returns page at to initiate your return. If you have questions, email

1 Review:

Liam 10.06.19

Rating - {addon_rating_average}

Immediately halted a mass spam attack on a site running E2.9. Five stars.