Here you can find properties of the fields that you have on your form and methods that can be used on them.

Insert them into JavaScript editor or inside OnClick setting for buttons and links.

Internal Name is the property that is used to identify specific fields and apply methods to them. Internal Name is unique for every element on the form.

Important! These events, methods and properties shouldn't be used on their own, they must be executed inside events like rendered() or beforeSave() in order to actually access the fields or controls that you target.

If you just add these scripts on their own or inside wrong event in JavaScript editor, they will not have access to the specified fields, or will execute at the wrong time. Read more about different events in Manager section.

For more use cases, check out our manual on how-to adjust fields dynamically on your form.


Most fields have these properties:

Property Description Examples
disabled Returns true if the field is disabled, allows to disable a field, making it essentially Read-only.
fd.field('TextBox').disabled = true;

Get or set placeholder for a field.

Only works for fields that have Placeholder property.

fd.field('TextBox').placeholder = 'Confirm Password';

Returns true if the field is required.

For SharePoint fields only adds or removes asterisk near the title.

For Plumsail fields it also adds validation.

fd.field('TextBox').required = true;
fd.field('TextBox').required = false;
title Allows to get or set field's title.
fd.field('TextBox').title = 'New Title';

Returns an array of field validators, can be used to add new ones.

These include simple validators for one field, that only check if specific field matches certain criteria or not.

If the field does not match the criteria, the form will not submit.

Note: Field validators will only work with Plumsail fields as all validation for SharePoint fields is configured via List Settings.

Use rendered() event for Plumsail forms and spRendered() event for SharePoint forms to add custom validators.


    name: 'MyCustomValidator',
    error: '',
    validate: function(value) {
        if (value <= 0) {
            this.error = 'Value must by greater than 0';
            return false;

        if (value > 2000) {
            this.error = 'Value must be less than 2000';
            return false;

        return true;

Allows to get or set field's value.

Plumsail fields and their value types:

  • TextBox, MultilineTextBox, DropDown, Radios – string
  • Checkboxes, DropDown(multiple) – array of strings
  • Date, DateTime – Date
  • Numeric – number
fd.field('TextBox').value = 'Hello, world!';
fd.field('Checkboxes').value = ['Choice1', 'Choice2'];
fd.field('Date').value = new Date();
fd.field('Numeric').value = 100;

Returns jquery-object lying under the Vue-component.

Usually it's a kendo component.



These methods are applicable to most fields:

Method Description Examples
clear() Clears the field.
validate() Checks to see if field is valid or not. If not, returns false, highlights field and adds error message under it.


Fields use $on() method to track the events happening to them.

Event Description Examples
change Triggers when field value is changed.
fd.field('TextBox').$on('change', function(value) {
    alert('New value: ' + value);
ready Triggers when the field is initialized and is ready to be used in scripts. Only available for People picker and Content Type SharePoint fields!
fd.spRendered(function() {
    fd.field('User').$on('ready',function(field) {
        // or

    fd.field('ContentType').$on('ready',function(field) {
        // or