Let your site visitors submit forms, for example feedback, requests, or inquiries. Scroll Sites sends submissions by email through your own Simple Mail Transfer Protocol (SMTP) server. To add a form to a page, see Add Forms to a Confluence Page.
Scroll Sites doesn’t store submissions. If it can’t send the email, the submission is lost and the visitor sees an error.
Set Up the Email Server
Before visitors can submit forms, enable forms for your account and set up your email server.
Enable forms
Contact us to enable forms for your account. Until then, Scroll Sites doesn’t show the email server setting.
Set up the email server
-
In Scroll Sites, go to Account settings > Forms macro email server.
-
Click Set up email server.
-
Enter the following details:
-
Server: Enter the host name of your SMTP server, for example
smtp.example.com. -
Encryption: Select None, STARTTLS, or SSL/TLS.
-
Port: Enter the port your SMTP server uses.
-
User name: Enter the user name for your SMTP server.
-
Password: Enter the password for your SMTP server.
-
Sender email: Enter the address that sends the form emails.
-
Sender name: Enter the name recipients see as the sender, for example Website Forms.
-
-
Click Verify and save. Scroll Sites tests the connection before it saves the settings.
-
Optional: Click Send test email to check delivery.
If you delete the email server, visitors can no longer submit forms.
Before you publish, check for the site issue Form without mail configuration. It appears when a page has a form but you haven’t configured an email server.
Contact us to enable forms for your account. Until then, the email server setting isn't shown in Scroll Sites.
What Visitors See
When a visitor submits a form, the following happens:
-
Scroll Sites checks required fields, allowed options, and the limit of 10,000 characters per field.
-
Scroll Sites shows the form’s success message after a successful submission.
-
If you enabled spam protection, Scroll Sites silently discards suspected bot submissions.
Email Format
Each form email has these parts:
-
From: The sender name and email from the email server settings
-
To and CC: The addresses you configured in the Scroll Form macro
-
Subject:
Form Submit from <page title> -
Body: Each submitted field as
<field name>: <value>, including hidden fields with their default value.
Migrating from Data Center
After migrating to Cloud, forms show Error loading the extension until they are converted.
Prerequisites
-
You have set up the email server.
-
You have Confluence admin permissions.
Convert forms
-
In Confluence, go to General Configuration > Apps > Scroll Exporter Extensions Macro Conversion Tool.
-
Open the Forms tab.
-
Click Start conversion.
Converted forms disappear from the list. Scroll Sites skips forms it can’t convert and marks them as skipped in the list. Contact us and we’ll help you migrate them.
If you use other legacy macros, see Convert Legacy Scroll Viewport Macros After Cloud Migration.