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: 10/2/2019, 7:59:34 PM