Skip to main content
A signature box has to end up somewhere on the page, and there are exactly two ways it gets there. The document chooses, not the request. If your PDF carries text tags, they win and detection does not run. If it carries none, the page is measured. Nothing merges the two, and there is no flag to make it. Which one you want follows from whether the documents are the same every time. A pack you send a hundred times is a template whose fields were placed once. A contract generated per employee — conditional clauses, a page count that varies with them — cannot reuse a template and has nothing dependable to detect either, because what is on page three this time is on page four the next. That is what tags are for, and a document like that is usually sent as a one-off envelope, which takes tags and nothing else.

Several sets of boxes, one answer

Printed forms often split one answer across more than one set of boxes: a telephone number as a dialling code and a number, or a date as day, month and year. Detection joins the ones it recognises when the document is uploaded (Field detection), and a document’s text tags can say it themselves (Several sets of boxes). For the rest, select those boxes in the template editor and choose Join as one answer. It sits beside Group as one question, and the two do opposite things. Grouping makes several tickboxes one question, each box an answer of its own. Joining makes several sets of boxes one field: one value, one API name and one validation. The value fills the boxes from the left, the first set before the next, and the editor states the split under the button. Split into separate fields, in the joined field’s Boxes band, turns it back into one field per set of boxes.
  • For example, joining a 3-box field named “Telephone (H)” with the 7-box field beside it makes one field named “Telephone (H)”, with validation phone, drawn across 3 + 7 boxes. The first box in reading order keeps its name; the field is required because one of the boxes was. “Number” is discarded, and the editor asks before it does that.
  • The API name it keeps is one somebody chose. The first box’s, if a person named it; else the one other box a person named, if exactly one did; else the first box’s own. A first box numbered form.text_001 beside one named contact.cell joins as contact.cell; two named boxes join as the first one’s, contact.dialling_code. A numbered name is not listed as discarded.
  • One answer is drawn in at most 8 sets of boxes. A joined date is 2 + 2 + 4 boxes or the reverse, and its name states the order, as in “Date of birth (DD/MM/YYYY)”.
  • When Join is refused, the button is shown disabled with one of these reasons:
    • These boxes are about different people. Two people’s boxes are two answers.
    • These boxes are filled in by different roles. Give them one role first.
    • These boxes are on different pages. One answer’s boxes are on one page.
    • “Number” is locked. Unlock it first.
    • “Number” decides when “Mobile” is asked. Remove that condition first.
    • “Number” is not drawn as printed boxes. Only boxes join as one answer.
    • These boxes do not spell a date: 3 + 5. A date in boxes is 2 + 2 + 4 or 4 + 2 + 2.
    • That is 9 sets of boxes, and one answer can be drawn in at most 8.
  • Split gives back one field per set of boxes. The first keeps the field’s name, API name and conditions, and a validation only if its own boxes can hold it: after splitting the example, the first field’s validation is removed. Each other set of boxes becomes a new field with the same role, person and requiredness, named at once by Vumasign, as a field drawn on the page is.
  • When Split is refused:
    • Its locked answer fills every box. Clear the answer first, then split it.
    • A date in boxes is one answer: its parts are not dates on their own. Change its boxes in the Boxes band instead, or delete it and place the date again.
    • “Telephone (H)” decides when “Mobile” is asked. Remove that condition first.
How an integration sends a value to a joined field is in One value in several sets of boxes.