TIP

WE'RE HIRING! 💼

The Solspace team is expanding! If you love Craft CMS and you’re looking for an exciting full-time remote position working on software development for the Freeform and Calendar plugins for Craft and more, we’d love to hear from you!

Check Out Job Listing!

Project Config

Freeform allows you to control/override its settings through Craft's Project Config if you wish. The following is preview of what is currently configurable whe using Craft's Project Config feaure:

freeform:
  edition: pro  # You'll get license errors if you don't have a valid Pro license.
  enabled: true
  schemaVersion: 3.0.4
  settings:
    pluginName: ''  # Custom name for plugin (Pro).
    defaultView: dashboard  # Default page to go to when clicking the Freeform nav item. Options are 'dashboard', 'forms', 'submissions'.
    fieldDisplayOrder: name  # Display order for the list of available fields in Composer. Options are 'name' or 'type'.
    showTutorial: ''  # Show the interactive tutorial again in Composer.
    removeNewlines: ''  # Have newlines removed from Textarea fields in submissions when exporting.
    defaultTemplates: '1'  # Disable to hide the default Freeform formatting templates in the Formatting Template options list inside Composer.
    scriptInsertLocation: form  # Location of where you want Freeform to insert its scripts for form and field functionality. Options are 'form', 'footer' or 'manual'.
    formSubmitDisable: '1'  # Disable submit button on form submit.
    renderFormHtmlInCpViews: '1'  # Enable live rendering of HTML inside Composer & Submissions views.
    ajaxByDefault: '1'  # AJAX enabled for forms by default.
    autoScrollToErrors: '1'  # Automatically scroll to form on errors and multipage forms.
    fillWithGet: '1'  # Fill form values from the GET query string.
    freeformHoneypot: '1'  # Enable Freeform's built in Honeypot spam protection.
    freeformHoneypotEnhancement: ''  # Require users have JS enabled in browser for Honeypot.
    customHoneypotName: ''  # Change default name of the Freeform Honeypot field. Default is 'freeform_form_handle'.
    customErrorMessage: 'No thanks'  # If form fails due to Spam protection AND Spam Protection Behavior setting is set to 'Display Error Messages', show this error message instead of the default.
    spamProtectionBehaviour: simulate_success  #  The behavior you'd like Freeform to take when it detects a submission as being spam. Options are 'simulate_success', 'display_errors' or 'reload_form'.
    spamFolderEnabled: '1'  # Enable Freeform's built-in spam folder.
    submissionThrottlingCount: ''  # Timeframe for form submission throttling.
    submissionThrottlingTimeFrame: m  # Timeframe for form submission throttling. Options are 'm' (minutes) or 's' (seconds).
    blockedEmails: '*@yahoo.com\n*.ru'  # Email addresses you would like blacklisted from being used in Email fields. Separate multiples with '\n'.
    showErrorsForBlockedEmails: '1'  # Show errors under affected fields.
    blockedEmailsError: 'Invalid Email Address'  # Error message to be shown when a blocked email address is used.
    blockedKeywords: "viagra\ncheesies\ntuna"  # Keywords you would like blocked. Separate multiples with '\n'.
    showErrorsForBlockedKeywords: ''  # Show errors under affected fields.
    blockedKeywordsError: 'Invalid Entry Data'  # Error message to be shown when a blocked keyword is used.
    blockedIpAddresses: ''  # IP addresses you would like blocked. Separate multiples with '\n'.
    purgableSubmissionAgeInDays: '0'  # Number of days Freeform should wait to purge submissions data. Use '0' to disable.
    purgableSpamAgeInDays: '0'  # Number of days Freeform should wait to purge spam submission data. Use '0' to disable.
    recaptchaEnabled: '1'  # Enable reCAPTCHA for forms.
    recaptchaKey: FAKEdf89g7dgfh0_df87g66gfdg60fdsg6sfh6df  # reCAPTCHA API key.
    recaptchaSecret: FAKEfd7g6df7g6df08df8f_df87g6df9g6df8g68  # reCAPTCHA API key secret.
    recaptchaType: v2_checkbox  # Which type of reCAPTCHA you want to use. Options are 'v2_checkbox', 'v2_invisible' (Pro) or 'v3' (Pro).
    recaptchaMinScore: '0.5'  # Enter the minimum score needed to pass the reCAPTCHA v3 test (Pro).
    recaptchaBehaviour: display_error  # The behavior to be used when reCAPTCHA fails. Options are 'spam' (send to Spam Folder) or 'display_error' (display error message in form).
    formTemplateDirectory: freeform_formatting/  # Where Formatting Templates are stored. Use complete path or Relative path to Craft templates directory.
    formattingTemplate: flexbox.html  # Default formatting template to be used for new forms.
    emailTemplateDirectory: freeform_emails/  # Where Email Notification Templates are stored. Use complete path or Relative path to Craft templates directory.
    emailTemplateStorage: db  # Storage method when creating new email notifications with 'Add New Notification' option in Composer. Options are 'db' and 'template'.
    hideBannerDemo: true  # Hide 'Install Demo' alert message banner.
    hideBannerOldFreeform: false  # Hide 'Old Freeform 2.x still installed' alert message banner.
  licenseKey: EXAMPLETEST12EXAMPLETEST
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
Last Updated: 1/14/2020, 3:35:55 PM