How Can We Help?

Automatically add linked items or files

You are here:
< All Topics

You can automatically add linked items or files to a new form using a custom js step within the Logic screen.

Here is an example of a function to do this. 

insertSublistItems('internal Linked List name', [
 { Internal field name: 'value', 
   Internal field name: 'value' 


  1. We do not recommend changing system fields.
  2. Make sure that steps and conditions that you create do not create an infinite loop, you should ensure that adding new items/files is stopped at some point.
  3. If from some reason during saving an error occurs (caused by invalid data in the sublist for example) – the main form and other sublists will be saved – unless they are invalid too.



Here are examples of the various field types and how to set their values:


    1. Single line

      SingleLine: 'First Image',


    2. Multi-line

      MultiLine: 'Three\nline\ntext',


      For multi-line rich text fields, you should use HTML syntax.


    3. Number

      Number: '7.5',


    4. Yes/No

      YesNo: '1',


      ‘Yes’ = 1, ‘No’ = 0


    5. Date and time / Date

      DateTime: new Date(2019, 5, 1, 6, 30), 


      Remember that months in JS are indexed from 0. So DateTime: new Date(2019, 5, 1), will give you 2019/06/01 i.e. January is 0.


    6. Person/Group

      PersonGroup: ['groupSite Owners'], 
      PersonMulti: ['', ''],


      The SharePoint group must exist, and the user must have permissions to access the group, otherwise, the record will be invalid and won’t save.


    7. Choice

      Dropdown: 'Choice 1', 
      Checkbox: ['Choice 1','Choice 2'], 
      Radiobutton: 'Choice 3',


    8. Hyperlink/Picture

      Hyperlink: { url: '', description: 'cat' }, 
      Picture: { url: '', description: 'space' }, 


    9. File (Document/Picture Library Linked List)

      File: { Name: 'hover-cat-flying-cat-2.jpg', Url: '' },


      If the link will be invalid for some reason the whole row won’t be added – be sure to check the given URL.


    10. Lookup

      Lookup: '1',


      The given number is an index of a list item from within the Linked List.


There are also two additional properties available:

notEditable: 'true',
notDeletable: 'true',

As the name suggests the first property causes that newly added items are not editable, the second property controls whether the items are deletable – this only applies to rows added via the insertSublistItems function

In the examples above the ‘true’ statement is redundant, it is only added to improve readability. Changing this to ‘false’ does not change the property so if you want newly added row(s) to be editable simply delete the notEditable property.


These properties only apply to linked items or files added to a new form using a custom js step within the Logic screen.








Was this article helpful?
5 out Of 5 Stars
5 Stars 100%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
How can we improve this article?
Table of Contents

Newsletter sign-up