Definition
Legacy markup is a term we use to identify the markup code and practices that existed in Gravity Forms prior to version 2.5 of our core product.
Purpose
Gravity Forms 2.5 was a major transition to more modern markup, and we overhauled the existing methods and styles to accommodate many accessibility enhancements, abandon some bad habits we have had for years, and to provide us with a more flexible and nimble methodology that can support upcoming features.
The legacy markup Form Setting was automatically enabled for existing forms on upgrade to Gravity Forms 2.5 and later, and was designed to allow backward compatibility with that release for the many millions of forms already in existence. New forms are created with the newer “modern markup” (legacy markup setting disabled), but legacy markup can be enabled for a newly created form if circumstances require.
For more information on what changes in 2.5, refer to this summary article.
Legacy Markup Toggle
The use of legacy markup is toggled within the Form Settings, therefore finding out if your form is using Legacy Markup is as easy as checking if your form has this setting enabled.
This article shows you where to find the setting.
Moving Forward
Although we recognize and support the need for backward compatibility, it is important to note that this does not imply forward compatibility.
Legacy markup will not be updated to support future functionality.
As such, forms continuing to use the legacy markup option will not have complete access to new features. Some features will require the newer markup in order to function. You may also be presented with a following admin notice to warn you of this when you have legacy markup enabled.
Clik here to view.
For example, the following features cannot be used while the legacy markup mode is set to on.
- The column feature of the Form Editor, where a user can drag content into columns.
- Some Submit button settings will not function. The Appearance settings of Submit Button Width and Submit Button Location will work in the editor, but will not display as expected on the front end
We recommend that all new forms use modern markup wherever possible. We also recommend that any time you need to make a major update to an existing form, you evaluate whether switching legacy markup off can be managed in order to ensure the most flexibility for your form moving forward.
The post About Legacy Markup appeared first on Gravity Forms Documentation.
