Recent software enhancements are in red.

The Visual Editor enables you to compose Activities and Messages in Salsa Engage. This article documents the Visual Editor as if it were a stand-alone part of Salsa Engage. However, in practice, the Visual Editor can be found only in the context of specific activities or emails. This help section covers the common options and standard workflows of the Visual Editor.

Many components of the visual editor are featured in all of Salsa Engage's forms, however, each form has unique elements, and each element has different editing tools. For example, Sign-Up Forms do not have payment configuration options since those elements don't apply to Sign-Up forms. Descriptions for creating various activities and emails can be found in their own articles.

Replace Elements in Older Activities and Emails

If you have older Activities that you want to copy, after the form has been cloned, you'll want to...

1. Delete any deprecated Form Elements.
2. Replace it with the new Form Element.

For instance, any forms older than 2018 with a Social Follow element (white social media buttons) should replace the Social Follow element with a new version of the element (colored social media buttons) by deleting the element and choosing it again from the Elements tab (described below).

Old 'Follow' Element	New 'Follow' Element

In another example, if you clone any older activities with Form elements, Salsa Engage will alert you to remove the existing form element and replace it with a new element.

Editing Activity and Email Content

Most of the work will be done from the Compose section of your activity or the Create the Email section of your messages. This is where you add, edit, or remove your activity metadata, page content, form elements, payment gateways, or third-party tracking codes. Click on the Edit Content button to get started or continue editing your page. All available elements are defined below.

The page edit screen displays a realistic view of your email or web page as you continue to add to and edit your content.

Elements must be embedded in rows. This makes it easier and quicker for you to build good-looking pages and emails. Salsa Engage supports nested rows up to two deep.

Moving your mouse over a page element will display an orange dashed line around the element that shows the extent of that element. A blue dotted line shows the extent of rows within the page putting your mouse over the row button.

The options available by clicking any of these icons will depend on the type of design element you're working on. For instance, selecting the pencil icon on an Image element will bring up your image library. Clicking the same icon on a Text element gives you an in-line text editor. It's important to not confuse Row controls with Element controls.

Element Container Settings

Features available via the Gear button for each element (also called Container Settings)...

• Design—Control the element padding, width, height, vertical scrolling within the element, border, corner style, and background.
  
• Mobile—All Salsa Engage forms are responsive by default. However, you may want to make further adjustments to this element based on the size of the display you expect your supporters will be using.
• Advanced CSS—In conjunction with Custom CSS added to Engage, you can list any custom CSS classes you want to apply to this element's container. You may define style declarations for these classes in the Custom CSS tab of your overall Design settings. Use the element ID in your Custom CSS to specify certain elements.
  
  Pro Tip: keep in mind that support for certain CSS declarations can vary widely by different browsers and devices and may even not be supported by different browsers and devices. Only those with advanced CSS skills should use this feature.

Element Edit Settings

Here is a brief description of the types of features that are available via the Pencil for each type of Element:

• Button—You can add a button anywhere on your form that links to another page. Once you've selected the Pencil, you can refine the button's attributes: Adjust the link, the positioning, and the size.
• Callout—When selecting the Pencil for this field, the Edit Featured Content window will open. It's a lot like the edit text window for the Text element. The important choice for this field, however, is made using the Design tab, in the upper right—hand corner of the visual editor. That's where you can adjust the color of the Callout field itself.
• HTML—Be careful when using this field. Use the Pencil if you want to tweak HTML directly. Keep in mind that you can break your form if your HTML is invalid or incorrect in any way.
• Image—For the Image element, the Pencil icon opens the Salsa Engage image library. Using the image library window, you can add images to your Salsa Engage form. Click here for an overview about adding images to and editing images in Salsa Engage. Click here to see images best practices.
• Merge Fields—Use the head and shoulders icon to open the Insert a merge field dialog box. Insert available merge fields and use the radio buttons to format capitalization. Also, enter the message that you want if the merge field for a supporter is blank.
  
• Share (Social)—You can add the option of sharing your form to social media, such as Facebook, Twitter, and Google+, to your forms. Select the Pencil to change the arrangement of these options vertically or horizontally and to decide which social media options you'd like to include or exclude. By default, all are chosen. You can also add a message which outlines why it is important that your supporters share this page. You can edit this verbiage with a slightly truncated version of the 'Edit Featured Content' window, explained in the Text section above.
• Text—Selecting the Pencil on the Text element will bring up the Edit Text window. The window features many of the editing tools that you are familiar with from popular desktop publishing tools, such as Microsoft Word and Google Docs. Hover over any icon in the window to see a description of what it is or just experiment.
• Everything Else—You will see additional Elements depending on the type of form you're building. If you're building a fundraising form, you won't see the 'Signatures' icon, but you will see it if you're building a petition. These are all editable with the Pencil, but you'll notice that some are grayed out. A grey icon indicates that the field is already included in the form and another cannot be added.

Text Element Merge Fields

Merge Fields enable you to insert dynamic text elements into your forms and messages. For example, the message could include a link to the supporter's fundraising page, so when your supporter sends a message to a donor, the donor will receive a link to the supporters fundraising page.

Supporter Type

• Address, line 1
• Address, line 2
• Cell Phone
• City
• Country
• Date of Birth
• Email Address
• First Name
• First Petition Signature Date
• Home Phone
• Last Name
• Last Petition Signature Date
• Middle Name
• State
• Subscription Change Date
• Subscription Date
• Suffix
• Supporter Since
• Title
• Total Petition Signatures
• Work Phone
• Zip Code
• [custom fields]

Fundraise Type

• Amount Of Most Recent Donation
• Average Donation Amount
• Average One-Time Giving Amount
• Average Recurring Giving Amount
• Date Of Most Recent Donation
• Largest Donation Amount
• Largest One-Time Giving Amount
• Largest Recurring Giving Amount
• Last One-Time Giving Amount
• Last Recurring Giving Amount
• Lifetime Giving Amount
• Lifetime Number of Donations
• Type Of Most Recent Donation
• [custom fields]

Organization Type

• Organization Name
• Org Address Line 1
• Org Address Line 2
• Org City
• Org State
• Org Zip
• Org Phone
• Org Email

Separate types exist for custom supporter, activity, and general custom fields and are unique to every organization.

Edit Content Page Functionality

At the top of the page, the grey toolbar contains information about which email or activity you're viewing, which page within the activity you're currently viewing, the live preview button, and save options. Along the right side is an Editor Menu that contains page settings, an outline mode, row items, and elements to add to the page.

Page Identity (A)

This section displays the activity or message type and name. If you are displaying an activity that has multiple page templates, like a peer-to-peer event that has a main page, a fundraiser page, and a team page to design, that page template type also displays here.

Page Navigation (B)

These links at the top of the page are called 'breadcrumbs' which represent a trail to follow through your site you are building. These links show you the current page that is displayed of all the pages in your activity as a little blue line below the page name. Clicking on that breadcrumb takes you to that page for editing that form. In the example above, this event form has 4 pages:

• The activity's Landing Page where visitors start their experience. That is the currently displayed page, indicated by the blue line below the link.
• The Registration form where tickets are selected and personal information filled out.
• The Checkout screen where supporters pay for their tickets.
• The Confirmation screen that confirms their registration was successful and directs supporters on what to do next.

Page Preview (C)

This button displays the message or activity in a new window with all the editing functionality removed. The Preview view enables you to save your work and see what your message or form HTML will look like in your browser, simulating the view in a browser, tablet, or mobile device.

• Click the Preview button to the top right of the editor to open a new browser tab.
• To the right of the new screen, use the Preview controls to toggle between computer screen, tablet, and a cell phone view of your content.

NOTE: Be sure to send yourself actual test emails before publishing. Emails render differently in various email clients from this web preview.

Pro Tip: It can be challenging to create emails that render well in all email clients, because email clients, unfortunately, have little standardization in the way they display HTML. Here is a helpful resource that other clients of ours have used to mitigate these kinds of problems: http://www.email-standards.org. Consider using a third—party program like litmus.com to test how your HTML email will perform in the myriad of different email programs. In addition, keep an eye on the breakdown of email clients accessing your content and start tailoring the design to the majority of those email clients your Supporters use.

Save Options (D)

The teal-colored Save button in the top right saves your progress when editing your activity or message. The Exit menu to the right of the Save button will allow you to...

• Save your work and exit the Edit screen.
• Cancel all changes since your last save and exit the Edit screen.

Editor Menu (E)

The Editor Menu by default can be found on the right side of the screen, but if you click on the yellow title area and drag it around the screen, you can reposition the Editor Menu wherever you wish. Just below that yellow area, the Hide Options area minimizes the Editor Menu's footprint temporarily as you work within your message or form.

Within the editor menu, you will find some buttons that will make large-scale changes to your message or form:

Settings

Update the look and feel of this form (and only this form) by changing the default design settings located here. If you want to change the style of a specific headline, field, or piece of copy, you can do that by going into the visual editor for that specific element. The global changes you can set here pertain to...

Global Setting	Description
Page Settings	Page color or background image Content area color Maximum content area width
Text Element Settings	Font Font color Font size Link color Divider color
Button Element Settings	Background color Text color Border Corner style Button size Button style
Callout Element Settings	Background color Text color Border Corner style Padding
Form Element Settings	Field border Field corner style Field padding
Custom CSS	If you wish, you can write your own custom CSS for your form. The styles you define here will be included in the final output. These styles will not be applied in Edit mode, but you will see them in the Preview and Published versions. NOTE: Keep in mind that support for certain CSS declarations can vary widely between browsers and devices and may even not be supported by different browsers and devices. Only those with advanced CSS skills should use this feature.

 

Add A Row

This button item displays a menu of drag-and-drop columns that include Header and Footer, but also multi-columns and sidebars. The Rows menu also include pre-formatted configurations into which you can easily place your Elements. This makes it easier and quicker for you to build good—looking pages and emails. Salsa Engage supports nested rows up to two rows deep.

Click the Add a Row button, and then drag the row option into the cell that you want to break into rows.

Add An Element

Elements enable you to add various content to Activity forms. Elements must always exist within Rows. Click the Add an Element button, and then click and drag any Element into the Row container to which you want it added. An Options dialog box will open for the Element that you've placed. See Font and Element Options for a detailed list of available Elements and what you can do with them.

The best way to learn what options are available for Elements that are already on a form is to hover over any Element you are interested in, click the pencil icon, and experiment with the various options. For example, if you are in a Fundraising form on a donation amount button, click the pencil icon. A dialog box will open in which you can change...

• The button type (Traditional or Radio Style).
• Whether a donor should have options for a One Time Gift, Recurring Gift or Both.
• Suggested donation amounts.
• How often the donation will be collected (Once a Month or Once a Year).
• Button design.

If you've made changes that you do not want to keep, click Cancel to close the dialog box without saving changes.

NOTE: Some elements can be used only once. If one of these Elements is already included in your form, it will be grayed out in the Elements tab.

Outline Mode

Working with embedded rows in your form or email can be tricky. Outline view is particularly useful for managing embedded rows. The Outline view enables you to shift Rows or Elements in your form. Click the Outline switch button to toggle the screen into outline mode. The Outline Mode ON button replaces the Outline Mode OFF button.

• When Outline Mode is OFF, to the upper-left corner of each Element and each object within an element is a small, orange rectangle with white dots.
  
  Click this rectangle to open a menu that enables you to move the Element.
  
• When Outline Mode is OFF, Click on the teal Row button (above) to switch to Row control. Click the teal dots icon, hold, and drag the icon to move entire row.
  
• When Outline Mode is ON, click the grey icon dots, hold, and drag the icon to move entire element.
  

Element Warnings

Some elements need information that is important to the proper functioning of the element. When that information is not available, Salsa Engage will warn you that more information is needed.

For instance, you have a map element on your home page, but you have not added an address to your event. Salsa Engage will produce a warning on the Editor Menu and a warning icon on the element as a visual reminder that the information needs to be included. Clicking on the red Editor Menu warning displays the items that require your attention.

You can also put your mouse over the red element warning symbol to see the warning for that particular element.

Row Controls

• Row Settings—Use the icon that looks like small, interlocking gears is where to select a background color or image, border, padding, corner style, and mobile adjustments for the given cell.
  
• Duplicate Row—Use the icon that looks like loosely stacked sheets of paper to duplicate the row and place the new copy in certain locations, as in the example below:
  • Copy to top.
  • Copy to Registration.
  • Copy to Checkout.
  • Copy to Confirmation.
    
• Delete Row—Use the 'trashcan' icon to delete the given row. You'll be prompted before the row is deleted forever. There is no Undo function with this step.

Element Controls

• Element Container Settings—Here is a brief description of the types of features that are available via the 'gear' icon for each type of Element:
  • Design—Control the element padding, width, height, vertical scrolling within the element, border, corner style, and background.
  • Mobile—All Salsa Engage forms are responsive by default. However, you may want to make further adjustments to any element based on the size of the display you expect your supporters will be using to view your forms or emails.
  • Advanced CSS—In conjunction with Custom CSS added to Engage, you can list any custom CSS classes you want to apply to this element's container. You may define style declarations for these classes in the Custom CSS tab of your overall Design settings. Use the element ID in your Custom CSS to specify certain elements.
    
    Pro Tip: Keep in mind that support for certain CSS declarations can vary widely by different browsers and devices and may even not be supported by different browsers and devices. Only those with advanced CSS skills should use this feature.
    
    
• Edit Element—Use the 'pencil' icon to edit each type of Element:
  • Button—You can add a button anywhere on your form that links to another page. Once you've selected the Pencil, you can refine the button's attributes: Adjust the link, the positioning, and the size.
  • Callout—When selecting the Pencil for this field, the Edit Featured Content window will open. It's a lot like the edit text window for the Text element. The important choice for this field, however, is made using the Design tab, in the upper right-hand corner of the visual editor. That's where you can adjust the color of the Callout field itself.
  • HTML—Be careful when using this field. Use the Pencil if you want to tweak HTML directly. Keep in mind that you can break your form if your HTML is invalid or incorrect in any way.
  • Image—For the Image element, the Pencil icon opens the Salsa Engage image library. Using the image library window, you can add to your form and images to Salsa Engage. Click here for an overview about adding images to and editing images in Salsa Engage. Click here to see images best practices.
  • Merge Fields—Use the head and shoulders icon to open the Insert a merge field dialog box. Merge Fields enable you to insert dynamic text elements into your forms and messages. For example, the message could include a link to the supporter's fundraising page, so when your supporter sends a message to a donor, the donor will receive a link to the supporters fundraising page. Insert available merge fields and use the radio buttons to format capitalization. Also, enter the message that you want if the merge field for a supporter is blank.
  • Share (Social)—You can add the option of sharing your form to social media, such as Facebook and Twitter, to your forms. Select the Pencil to change the arrangement of these options vertically or horizontally and to decide which social media options you'd like to include or exclude. By default, all are chosen. You can also add a message which outlines why it is important that your supporters share this page. You can edit this verbiage with a slightly truncated version of the 'Edit Featured Content' window, explained in the Text section above.
  • Text—Selecting the Pencil on the Text element will bring up the Edit Text window. The window features many of the editing tools that you are familiar with from popular desktop publishing tools, such as Microsoft Word and Google Docs. Hover over any icon in the window to see a description of what it is or just experiment.
  • Everything Else—You will see additional Elements depending on the type of form you're building. If you're building a fundraising form, you won't see the 'Signatures' icon, but you will see it if you're building a petition. These are all editable with the Pencil, but you'll notice that some are grayed out. A grey icon indicates that the field is already included in the form and another cannot be added.
• Delete Element—Use the 'trashcan' icon to delete the given row. You'll be prompted before the row is deleted forever. There is no Undo function with this step.

Linking

You can add hyperlinks to the following Elements:

• Text element links to both 'Your Pages' created in Engage and 'An External Page' that exists entirely outside of Engage.
  
• Button element links to both 'Your Pages' created in Engage and 'An External Page' that exists entirely outside of Engage.
• Image Element links to both 'Your Pages' created in Engage and 'An External Page' that exists entirely outside of Engage.

In addition, if you choose to code your own HTML, you can add links to both 'Your Pages' created in Engage and 'An External Page' that exists entirely outside of Engage.

Append Donation Preset Fields

You can set parameters for outgoing links from Engage emails, once you have selected the link source. One example is a link whose content says, 'Your donation of $20 will fill a backpack for a child. Donate $20 today!' The $20 donation amount will be passed to the destination form and preselected based on conditions set on the link.

If the destination form is an Engage form and you have Form Prefill enabled in your Settings, Engage always pre-populates the supporter's data (if known). However, using the tabs, as shown above, you can also append parameters to your link that will pre-populate data. In the case of fundraising forms, donation amounts or custom fields with specified values on the destination page when someone clicks on this link from their email.

NOTE: The Gift Designation field can be used in conjunction with this functionality.

A Default one-time or recurring donation amount may be set with the following parameters:

• A distinct Dollar Amount (in whole numbers)
• Most Recent One-Time Donation Amount
  • Increment By a specific percentage over the most recent amount.
  • With a Minimum Amount of a specific value or leave blank for none.
  • Default Amount to be used if none occurred previously, or leave blank for none.
    
• Average One-Time Donation Amount (rounded to nearest dollar)
  • Increment By a specific percentage over the most recent amount.
  • With a Minimum Amount of a specific value or leave blank for none.
  • Default Amount to be used if none occurred previously, or leave blank for none.
• Largest One-Time Donation Amount
  • Increment By a specific percentage over the most recent amount.
  • With a Minimum Amount of a specific value or leave blank for none.
  • Default Amount to be used if none occurred previously, or leave blank for none.
• Use A Custom Field—Any supporter custom fields that are Number-type fields.

If you choose to link from an external page or form, it is possible to specify the parameter that represents the amount field of that external form. Since there could be millions of combinations of what someone else called the amount field, it's not possible for us to prepopulate what that field would be on an external page. It can, however, be typed in.

Append Field Presets

For sign-up forms, you can automatically populate supporter custom fields based on answers previously submitted via sign-up form; for example, how many days of the week someone can volunteer. For example, if someone answered a question previously on a sign-up form, they have a value stored in their Engage record already. If they fill out another form that contains the same field, then the existing value is populated automatically when they use the form. If they are new, then your default values would be used, as seen below.

Salsa Tracking Codes

If you have many different communications channels pointing to an activity form (a fundraising form, for instance), and you want to differentiate the different ways that someone got to your Activity form, you can apply a Salsa Tracking Code to the URL used to get to the Activity form that makes that URL unique and reportable. For example, you're A/B testing emails and want to tell which donations came from which email. You'd add a Tracking Code to Email A and a different Tracking Code to Email B. Each tracking code would report separately in the Form Results reports.

The Tracking Code that you add, as seen in the image above, is just a single, unique word used to differentiate that link.