{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Split field","siteUrl":"https://developers.signable.app","description":"Integrate Signable’s eSignature API to send, sign, and manage documents with envelopes and webhooks.","image":"/assets/hero-placeholder-small.5b052639e5d5a3b6265375db1ac2835173dda2c0ed22f8c167f6284080cc84ce.db81178d.png","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"split-field","__idx":0},"children":["Split field"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A split field collects a single value across a row of cells. Use it where a printed form breaks one answer into boxes, such as a card number, a sort code or a National Insurance number. You place one field over the boxes instead of one text field per box, and the value can be validated as a whole."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Split fields are available from 10 November 2026."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-split-fields-work","__idx":1},"children":["How split fields work"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A split field is made of cells, runs and gaps."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["cell"]}," holds one character."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["run"]}," is a group of cells that sit together. A field has between 1 and 20 runs, and each run has between 1 and 25 cells."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["cell gap"]}," is the space between cells. It is one value shared by every run."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["run gap"]}," is the space between runs. It is one value for the whole field."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A card number printed as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1234 5678 9012 3456"]}," has four runs of 4 cells:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":" run 1          run 2          run 3          run 4\n[1][2][3][4]   [5][6][7][8]   [9][0][1][2]   [3][4][5][6]\n           |<->|\n          run gap\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Describe the printed form from left to right, then set the gaps to match the spacing between its boxes. Where boxes touch, use a cell gap of 0."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_number"]}," preset sets this layout for you and checks the value is 16 digits. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#presets"},"children":["Presets"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Limits"},"children":["Limits"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Runs per field"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 to 20"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cells per run"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 to 25"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cell gap"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0 or more. Defaults to 0"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run gap"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0 or more. Defaults to 0"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"presets","__idx":2},"children":["Presets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A preset sets a validation rule and, for most presets, a layout. Presets are for UK references."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Preset"},"children":["Preset"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Layout"},"children":["Layout"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it accepts"},"children":["What it accepts"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numeric"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None, set with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Digits only"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alphabetical"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None, set with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Letters only"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alphanumeric"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None, set with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Letters and digits only"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["4-4-4-4"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["16 digits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2-2-2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["6 digits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["national_insurance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2-2-2-2-1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A National Insurance number, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AB123456C"]},": two capital letters, six digits, then A, B, C or D"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utr"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["5-5"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A Unique Taxpayer Reference: 10 digits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uprn"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A Unique Property Reference Number: 1 to 12 digits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postcode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["7"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A UK postcode without the space, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SW1A1AA"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numeric"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alphabetical"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alphanumeric"]}," only limit which characters a signer can enter, so use them with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]},". For example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{split,p=numeric,l=8:signer1:Reference}"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can override a preset's layout or gaps. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#combine-options"},"children":["Combine options"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"validation","__idx":3},"children":["Validation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Validation restricts what a signer can enter. It comes from the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#presets"},"children":["preset"]},", and there is no separate validation option. The whole value must match, not part of it. An empty value is not validated unless the field is required."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A split field without a preset accepts any characters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The value is checked without separators, one character per cell."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Overriding a preset's layout keeps its validation. A layout that cannot fit the preset, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["p=card_number,l=4"]},", is accepted. The signer will never be able to enter a valid value, so check the layout still fits the preset."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Custom regular expressions are not supported."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-split-fields-with-document-tags","__idx":4},"children":["Create split fields with document tags"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Split tags use the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{WHAT:WHO:NAME}"]}," format as other ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tags"},"children":["tags"]},". Add options after ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]},", separated by commas. Options can appear in any order."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"{split,l=4-4-4-4,cg=2,rg=4:signer1:Card+Number}\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Layout. One cell count per run, joined by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-"]},". Required unless you use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["p="]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cg="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cell gap, shared by every run. Defaults to 0"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rg="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run gap. Defaults to 0"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["p="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#presets"},"children":["preset"]},", which sets validation and, for most presets, the layout"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Placed after ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]}," to make the field optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["w"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["h"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Width and height in PDF units, as described in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tags#adjust-field-dimensions"},"children":["Tags"]},". Set width before height"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gaps are measured in PDF units, the same as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["w"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["h"]},". The tag-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["g"]}," option used for other fields is unrelated to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cg="]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"build-a-tag","__idx":5},"children":["Build a tag"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tags#build-a-tag"},"children":["tag builder"]}," and choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Split"]}," to put a tag together, then copy it into your document."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"set-a-layout","__idx":6},"children":["Set a layout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]}," takes run cell counts only. Gaps are set separately with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cg="]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rg="]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"{split,l=9:signer1:Reference}\n{split,l=5-10,cg=2:signer1:Reference}\n{split,l=4-4-4-4,cg=2,rg=4:signer1:Card+Number}\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The first gives one run of 9 cells. The second gives two runs sharing a cell gap of 2. The third gives four runs of four cells with a cell gap of 2 and a run gap of 4."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"use-a-preset","__idx":7},"children":["Use a preset"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"{split,p=card_number:signer1:Card+Number}\n{split?,p=utr,w200:signer1:UTR}\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"combine-options","__idx":8},"children":["Combine options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["p="]}," to override the preset's layout. The preset's validation still applies."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"{split,p=card_number,l=16,cg=2:signer1:Card+Number}\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This keeps the card number check but lays the 16 cells out as one run, for a form that prints the boxes without breaks."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cg="]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rg="]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["p="]}," overrides the preset's gaps."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tags-that-are-ignored","__idx":9},"children":["Tags that are ignored"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A split tag with any of these problems is ignored, so no field is created. If a field you expect is missing after upload, check its tag against this list."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Problem"},"children":["Problem"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example"},"children":["Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["p="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{split:signer1:Card}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A preset with no layout, and no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{split,p=numeric:signer1:Ref}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]}," is not a layout"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{split,l=card_number:signer1:Card}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Gaps written inside ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{split,l=4g2-4:signer1:Ref}"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{split,l=4-4-rg2:signer1:Ref}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A run with 0 cells, or more than 25"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{split,l=26:signer1:Ref}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["More than 20 runs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]}," with 21 counts"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cg="]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rg="]}," is not a whole number of 0 or more"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{split,l=4,rg=abc:signer1:Ref}"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cg=-1"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An option repeated"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{split,l=4,cg=2,cg=4:signer1:Ref}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unknown preset"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{split,p=nope:signer1:Card}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["l="]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cg="]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rg="]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["p="]}," on another field type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{text,cg=2:signer1:Name}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tag wraps across two lines"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reduce the font size so the tag stays on one line"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"read-completed-values","__idx":10},"children":["Read completed values"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your integration validates ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["field_type"]}," against a fixed list, add the new type before 10 November 2026."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-documentation","__idx":11},"children":["Related documentation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tags"},"children":["Tags"]}," – The full tag syntax"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/send-envelope/send-envelope-uploaded-document"},"children":["Send an envelope with an uploaded document"]}," – Use tags when uploading a document"]}]}]},"headings":[{"value":"Split field","id":"split-field","depth":1},{"value":"How split fields work","id":"how-split-fields-work","depth":2},{"value":"Presets","id":"presets","depth":2},{"value":"Validation","id":"validation","depth":2},{"value":"Create split fields with document tags","id":"create-split-fields-with-document-tags","depth":2},{"value":"Build a tag","id":"build-a-tag","depth":3},{"value":"Set a layout","id":"set-a-layout","depth":3},{"value":"Use a preset","id":"use-a-preset","depth":3},{"value":"Combine options","id":"combine-options","depth":3},{"value":"Tags that are ignored","id":"tags-that-are-ignored","depth":3},{"value":"Read completed values","id":"read-completed-values","depth":2},{"value":"Related documentation","id":"related-documentation","depth":2}],"frontmatter":{"title":"Split field","description":"Collect one value across a row of cells that line up with the printed boxes on a form","category":"Reference","keywords":["split field","cells","runs","cell gap","run gap","presets","validation","tags","National Insurance number","sort code","UTR","card number"],"seo":{"title":"Split field"}},"lastModified":"2026-11-08T21:53:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/field-types/split","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}