User Guide Cancel

Customize PDF form fields

Before you begin

Acrobat now has an improved interface, as shown. If you see a different experience, refer to help for your current experience.

Acrobat tools are dispalyed in the left pane.

About form field properties

You can use the Acrobat form field Properties to control how the field behaves. This includes setting formatting rules, defining interactions with other fields, imposing input limits, and integrating custom scripts.

Key points:

  • Each form field type has its own dedicated set of properties, neatly organized into tabs.
  • Adjustments to properties take effect immediately upon moving to another property or pressing Enter.
  • All form fields feature a General tab and an Actions tab, with additional tabs like the Options tab, tailored to specific field types.
  • Two universal options are available on every tab: "Locked," which prevents further alterations to field properties, and "Close," which exits the Properties dialog box. If modifying multiple fields, you can keep the dialog box open and seamlessly toggle between fields to make changes.
Adobe Acrobat deeplink

Try it in the app
Customize PDF form fields in a few simple steps.

Modify general properties of form field

  1. If you are not in form editing mode, choose All tools > Prepare a form.

    Prepare a form

  2. Open the Properties dialog box using one of the following methods:
    • To edit a single form field, double-click it or right-click it and choose Properties.

    • To edit multiple form fields, select the fields that you want to edit, right-click one of the selected fields, and choose Properties.

  3. In the General tab, you can change the following options: 

    • NameSpecifies the unique name of the selected form field.
    • TooltipDisplays text that the hesitant user may find helpful in filling in the form field. Tooltips appear when the pointer hovers briefly over the form field.
    • Form FieldSpecifies whether the form field can be seen, either on screen or in print. The available choices are: Visible, Hidden, Visible But Doesn’t Print, and Hidden but printable.
    • OrientationRotates the form field by 0, 90, 180, or 270 Degrees
    • Read OnlyPrevents the user from changing the form field content.
    • Required: Makes the field mandatory for the user. If the user attempts to submit the form while a required field is blank, an error message appears and the empty required form field is highlighted.

    The property is changed as soon as you select another property or press Enter.

  4. Select Close.

Note:

If you select form fields that have different property values, some options in the Properties dialog box are not available. Otherwise, changes to the available options are applied to all selected form fields.

Modify the appearance of form field

In the Appearance tab, you can adjust how the form field visually presents on the page. This tab is available for all form field types except barcodes and offers the following options:

  • Border Color: Choose a color for the field frame or opt for no frame.
  • Line Thickness: Determine the thickness of the field frame (Thin, Medium, or Thick).
  • Fill Color: Select a background color for the field or keep it transparent.
  • Line Style: Alter the appearance of the frame with options like Solid, Dashed, or Underline.
  • Font Size: Set the size of entered text or selection markers, with an Auto option for dynamic resizing.
  • Text Color: Choose a color for the text or selection marker.
  • Font: Select from available fonts on your system (not applicable for non-text displaying fields).
Note:

Using a Fill Color other than transparent may obscure images behind the form field on the PDF page.

Note:

The Enable Right-To-Left Language Options in the Language panel of the Preferences dialog box affects what appears in the Appearance tab of the Properties dialog box. When that preference is selected, the Appearance tab includes options for changing the digit style and text direction for text fields, drop-down list boxes, and list boxes.

Position the form field

The Position tab enables you to position or resize the currently selected field(s) accurately to within a precision of up to 10,000th of an inch. You can also move fields to precise locations on the page.

Use the Height and Width options to change only the size of fields. To relocate fields without changing their dimensions, select Do Not Change Height And Width When Changing The Position.

Form field accuracy upto 10,000th of an inch

Modify field specific properties

The Options tab for form field properties adapts according to the selected form field type, excluding digital signatures. Below are the options available for various field types.

Barcode:

  • Symbology: Choose from PDF417, QR Code, and Data Matrix barcode types.
  • Compress Data Before Encoding to Barcode: Compresses data before encoding for reduced storage space.
  • Decode Condition: Preset decode conditions, customizable with the Custom button.
  • Custom: Customize processing parameters for your specific hardware.
  • X Dimension: Width of the barcode cell in mils.
  • Y/X Ratio: Height/width ratio of the cell.
  • Error Correction Level: Determines data redundancy for error correction. Higher error correction levels create more reliable barcodes but result in larger sizes and limited capacity for encoding additional data. This feature is available for PDF417 and QR Code barcodes, reducing issues like printing defects, fax transmission errors, and document damage.
  • Manage Barcode Parameters: Save and share custom barcode selections.

Check Boxes:

  • Check Box Style: Shape of the marker inside the checkbox.
  • Export Value: Value representing the item for data export.
  • Check Box Is Checked By Default: Pre-selects the checkbox.

Drop-down and List Box:

  • Item: Text for options displayed in the menu.
  • Add: Moves the current entry to the Item List.
  • Export Value: Value representing the item for data export.
  • Item List: Displays available choices.
  • Up and Down buttons: Change item order. These buttons are not available if 'Sort Items' is selected.
  • Delete: Removes selected item.
  • Sort Items: Numerically and alphabetically arrange items.
  • Allow User To Enter Custom Text: Enables custom text entry.
  • Check Spelling: Spelling check for user-entered text.
  • Multiple Selection: Allows choosing multiple items.
  • Commit Selected Value Immediately: Saves the value immediately.

Radio Buttons:

  • Button Style: Shape of the marker inside the button.
  • Radio Button Choice: Identifies the radio button.
  • Button Is Checked By Default: Pre-selects the button.
  • Buttons With The Same Name And Content Are Selected In Unison: Allows single-click selection of related radio buttons.

Text Fields:

  • Alignment: Aligns text left, right, or center.
  • Default Value: Initial text in the field.
  • Multi-line: Allows multiple-line entries.
  • Scroll Long Text: Compensates for extended text.
  • Allow Rich Text Formatting: Enables text styling.
  • Limit Of Characters: Sets character limit.
  • Password: Displays entered text as asterisks.
  • Comb of characters: Spreads the user-entered text evenly across the width of the text field. If a border color is specified in the Appearance tab, each character entered in the field is separated by lines of that color. This option is available only when no other check box is selected.
Note:

If you plan to decode the barcode using a handheld laser scanner, avoid creating barcodes wider than 4 inches (10.2 cm). Tall and narrow barcodes generally work better with handheld scanners. Barcode height and width will not be an issue using an Adobe barcode decoder (available separately).

Note:

The highlighted item in the Item List box appears as the default selected item in the dropdown box or list box field. To change the default item, highlight another item from the list.

Text fields in Acrobat
Text fields with and without the Comb property

A. Four text fields with a border color, using the Comb property B. Text field without the Comb property 

Set form fields actions

The Actions tab in form field properties allows you to assign actions triggered by user interactions. Here are its key components:

  • Select Trigger: Choose the user action that initiates the action, such as Mouse Up, Mouse Down, Mouse Enter, Mouse Exit, On Focus, or On Blur.
  • Select Action: Specify the event that occurs when the user triggers the action. Options include executing a menu item, navigating to a 3D/Multimedia view, going to a page view, importing form data, opening a file or web link, playing a sound or media clip, reading an article, resetting a form, running JavaScript, setting layer visibility, showing/hiding a field, or submitting a form.
  • Add: Opens a window to select and add an action.
  • Actions: Displays the list of defined triggers and actions.
  • Up and Down buttons: These buttons change the order of the listed actions under the trigger (available when multiple actions are defined for the same trigger).
  • Edit: Opens a dialog box with specific options for the selected action.
  • Delete: Removes the selected action or trigger-action pair.

Set form fields for calculations

The Calculate tab in form field properties excludes text fields and dropdown boxes. It offers options for performing mathematical operations on existing entries and displaying results:

  • Value Is Not Calculated: Choose this option if you want users to input values manually.

  • Value Is The: Select this to access additional options:

    • Pop-up Menu: This menu lists mathematical functions like Sum, Product, Average, Minimum, or Maximum that
      apply to selected fields.

    • Pick: Opens a dialog box listing available form fields to include or exclude from the calculation.

  • Simplified Field Notation: Utilizes JavaScript with field names and basic arithmetic signs. Use the Edit button to modify or add scripts.

  • Custom Calculation Script: Shows any custom scripts for calculations. Use the Edit button to create or edit JavaScripts.

Note:

Field names are case-sensitive.

Set the calculation order of form fields

In your form, the order of calculations follows the sequence in which you define them.

Adjust the calculation order if necessary for accurate results. For instance, if you need the outcome of two fields to compute a third, ensure those two fields are calculated first.

  1. Select  > Set Field Calculation Order.

    The Calculated Fields dialog box displays all calculable fields in your form and the order in which the calculations are performed.

  2. To change the field calculation order, select the field from the list, and then select the Up or Down button as needed.

Acrobat automatically performs all assigned field calculations when you are creating and testing your form fields. For convenience, while you work, you can turn off automatic calculation in the forms preferences.

Set e-signature properties

You can set e-signature properties using the Signed tab in the Digital Signature Properties dialog box. Your selections determine what happens when the user applies a digital signature to the form.

Options include:

  • Nothing Happens When Signed: This is the default setting.
  • Mark As Read-Only: Determines post-signature changes. Options include:
    • All Fields: Locks all form fields.
    • All Fields Except These: Allows edits in selected fields.
    • Just These Fields: Locks only selected fields.
  • This Script Executes When Field Is Signed: Enables custom JavaScript execution post-signature. Use the Edit button to modify or create new JavaScript actions.

Format text and dropdown fields

The Format tab in Form Field Properties offers various formatting options for text and dropdown fields. The options depend on your selection in the Select Format Category pop-up menu. The Example of Current Format field displays a live preview of the settings. 

The available options are:

The "Format" tab in form field properties offers various formatting options for text and dropdown fields. Here's a breakdown:

  • None: No specific formatting is required.
  • Number: Automatically formats numeric entries. Options for decimal places, separator style, currency symbol, symbol location, and negative number style.
  • Percentage: Formats numeric data as percentages. Options for decimal places and separator style.
  • Date: Format dates. Options for one-, two-, and four-digit date variations.
  • Time: Formats time entries. Options for 12-hour or 24-hour clock display, minutes, seconds, and AM/PM.
  • Special: Formats specific data types such as Zip Code, Zip Code + 4, Phone Number, and Social Security Number. Allows for an Arbitrary Mask for custom formats. 
    • A - Accepts only letters (A–Z, a-z).
    • X - Accepts spaces and most printable characters, including all characters available on a standard keyboard and ANSI characters in 32–126 and 128–255.
    • O - The letter “O” accepts alphanumeric characters (A–Z, a-z, and 0–9).
    • 9 - Accepts only numeric characters (0–9).
    • For example, a mask setting of AAA--p#999 accepts the input BOE--p#767. A mask setting of OOOOO@XXX accepts the input vad12@3Up.
  • Custom: This option enables advanced formatting using custom JavaScript scripts. It also offers options to add and edit custom format and keystroke scripts. To get the JavaScript for Acrobat API Reference, see the Acrobat Developer Center at www.adobe.com/go/learn_acr_javascript_en (PDF, English only).

The "Validation" tab, available in Text Field and Dropdown Box Properties, ensures data accuracy:

  • Field Value Is Not Validated: Disables validation.
  • Field Value Is In Range: Sets numeric range limits.
  • Run Custom Validation Script: Validates using custom JavaScript scripts.

No additional options are available. The input in a text or dropdown box with this property does not require any specific formatting.

Arbitrary Mask entry in Acrobat
Example of an Arbitrary Mask entry

Set barcode field properties

The "Value" tab in form field properties is exclusive to barcode fields and offers these options:

  • Encode Using: Allows selection of encoding methods. Options include:
    • XML: Encodes data in standard XFDF format, generating JavaScript script automatically.
    • Tab Delimited: Encodes fields as tab-delimited values, useful for fitting more data into the barcode or for copying data into database or spreadsheet tables. JavaScript script is automatically generated. If the form outputs data in XFDF or XDP files, it must be in tab-delimited format with field names on the first line.
  • Pick: Opens a dialog box to select user data fields for barcode encoding.
  • Include Field Names:
    • Only available with Tab Delimited encoding.
    • Encodes field names as the first line of barcode contents with values encoded below them.
  • Custom Calculation Script:
    • Displays default script.
    • Click "Edit" to open the JavaScript Editor for custom calculation scripts.
  • Reference To Published Form:
    • Displays the path to the PDF form.
    • Allows editing the URL to the published form.
    • Helps recreate a digital version of the completed form by merging the form template with user-supplied data.
    • Maintains the relationship between form template and barcode data files.
    • When encoding a barcode using XML values, the URL reference is encoded into the barcode and displayed below it.
A type of barcode, with the URL reference below
A type of barcode, with the URL reference below

Manage custom barcode settings

You can save, reuse, and share a set of custom settings for barcode parameters, to apply them when you create new barcode form fields. You can make further adjustments to your custom parameter sets after you define them.

All of these processes begin by opening the barcode form field properties dialog box. To open the properties dialog box, double-click the barcode field.

Create a new barcode parameters set

  1. In the Barcode Field Properties dialog box, select the Options tab, and then select Manage Barcode Parameters.

  2. Select the existing parameter set that you want to use as the basis of the new set, and select New.

  3. Type a name in the Name box and a description in the Description box.

  4. Select options for Symbology, X Dimension, Y/X Ratio, and Error Correction Level, and then select OK.

The newly defined parameter set appears in the list in the Manage Barcode Parameters dialog box, and all the buttons on the right side of the dialog box become available. The new definition also appears in the Decode Condition menu in the Options tab of the Barcode Field Properties dialog box.

Edit or delete a set of custom barcode parameters

  1. In the Barcode Field Properties dialog box, select the Options tab, and then select Manage Barcode Parameters.

  2. Select a custom parameter set from the list.
  3. Choose the appropriate action:
    • Select Edit and make the changes to the settings; then select OK.

    • Select Delete. Confirm the deletion in the message that appears by selecting OK.

Export or import a set of custom barcode parameters

  1. In the Barcode Field Properties dialog box, select the Options tab, and then select Manage Barcode Parameters.

  2. Choose the appropriate action:
    • Select a barcode parameter set from the list and select Export. Select a location and file name for the file that has the file name extension .bps.

    • Select Import, and navigate to and select the BPS file that you want to import.

Redefine form field property defaults

After you change properties for a specific type of form field, you can set those properties as the default set for that type. For example, you can create a checkbox, change its properties, and then save the properties as the default values. The default values can be only for Appearance and Size related attributes of the field. Properties for format related attributes like Date cannot be set as default.

  1. Select All tools > Prepare a form to go to form-editing mode.

  2. Right-click the form field for which you have already changed properties, and choose Use Current Properties As New Defaults.

Note:

Changing the default properties does not change the settings for existing form fields of that type. The new defaults apply only to new fields that you create.

  1. Acrobat User Guide
  2. Introduction to Acrobat
    1. Access Acrobat from desktop, mobile, web
    2. Introducing the new Acrobat experience
    3. What's new in Acrobat
    4. Keyboard shortcuts
    5. System Requirements
  3. Workspace
    1. Workspace basics
    2. Opening and viewing PDFs
      1. Opening PDFs
      2. Navigating PDF pages
      3. Viewing PDF preferences
      4. Adjusting PDF views
      5. Enable thumbnail preview of PDFs
      6. Display PDF in browser
    3. Working with online storage accounts
      1. Access files from Box
      2. Access files from Dropbox
      3. Access files from OneDrive
      4. Access files from SharePoint
      5. Access files from Google Drive
    4. Acrobat and macOS
    5. Acrobat notifications
    6. Grids, guides, and measurements in PDFs
    7. Asian, Cyrillic, and right-to-left text in PDFs
  4. Creating PDFs
    1. Overview of PDF creation
    2. Create PDFs with Acrobat
    3. Create PDFs with PDFMaker
    4. Using the Adobe PDF printer
    5. Converting web pages to PDF
    6. Creating PDFs with Acrobat Distiller
    7. Adobe PDF conversion settings
    8. PDF fonts
  5. Editing PDFs
    1. Edit text in PDFs
    2. Edit images or objects in a PDF
    3. Rotate, move, delete, and renumber PDF pages
    4. Edit scanned PDFs
    5. Enhance document photos captured using a mobile camera
    6. Optimizing PDFs
    7. PDF properties and metadata
    8. Links and attachments in PDFs
    9. PDF layers
    10. Page thumbnails and bookmarks in PDFs
    11. PDFs converted to web pages
    12. Setting up PDFs for a presentation
    13. PDF articles
    14. Geospatial PDFs
    15. Applying actions and scripts to PDFs
    16. Change the default font for adding text
    17. Delete pages from a PDF
  6. Scan and OCR
    1. Scan documents to PDF
    2. Enhance document photos
    3. Troubleshoot scanner issues when scanning using Acrobat
  7. Forms
    1. PDF forms basics
    2. Create a form from scratch in Acrobat
    3. Create and distribute PDF forms
    4. Fill in PDF forms
    5. PDF form field properties
    6. Fill and sign PDF forms
    7. Setting action buttons in PDF forms
    8. Publishing interactive PDF web forms
    9. PDF form field basics
    10. PDF barcode form fields
    11. Collect and manage PDF form data
    12. About forms tracker
    13. PDF forms help
    14. Send PDF forms to recipients using email or an internal server
  8. Combining files
    1. Combine or merge files into single PDF
    2. Rotate, move, delete, and renumber PDF pages
    3. Add headers, footers, and Bates numbering to PDFs
    4. Crop PDF pages
    5. Add watermarks to PDFs
    6. Add backgrounds to PDFs
    7. Working with component files in a PDF Portfolio
    8. Publish and share PDF Portfolios
    9. Overview of PDF Portfolios
    10. Create and customize PDF Portfolios
  9. Sharing, reviews, and commenting
    1. Share and track PDFs online
    2. Mark up text with edits
    3. Preparing for a PDF review
    4. Starting a PDF review
    5. Hosting shared reviews on SharePoint or Office 365 sites
    6. Participating in a PDF review
    7. Add comments to PDFs
    8. Adding a stamp to a PDF
    9. Approval workflows
    10. Managing comments | view, reply, print
    11. Importing and exporting comments
    12. Tracking and managing PDF reviews
  10. Saving and exporting PDFs
    1. Saving PDFs
    2. Convert PDF to Word
    3. Convert PDF to PPTX
    4. Convert PDF to XLSX or XML
    5. Convert PDF to JPG
    6. Convert PDF to PNG
    7. Convert or export PDFs to other file formats
    8. File format options for PDF export
    9. Reusing PDF content
  11. Security
    1. Enhanced security setting for PDFs
    2. Securing PDFs with passwords
    3. Manage Digital IDs
    4. Securing PDFs with certificates
    5. Opening secured PDFs
    6. Removing sensitive content from PDFs
    7. Setting up security policies for PDFs
    8. Choosing a security method for PDFs
    9. Security warnings when a PDF opens
    10. Securing PDFs with Adobe Experience Manager
    11. Protected View feature for PDFs
    12. Overview of security in Acrobat and PDFs
    13. JavaScripts in PDFs as a security risk
    14. Attachments as security risks
    15. Allow or block links in PDFs
  12. Electronic signatures
    1. Sign PDF documents
    2. Capture your signature on mobile and use it everywhere
    3. Send documents for e-signatures
    4. Create a web form
    5. Request e-signatures in bulk
    6. Collect online payments
    7. Brand your account
    8. About certificate signatures
    9. Certificate-based signatures
    10. Validating digital signatures
    11. Adobe Approved Trust List
    12. Manage trusted identities
  13. Printing
    1. Basic PDF printing tasks
    2. Print Booklets and PDF Portfolios
    3. Advanced PDF print settings
    4. Print to PDF
    5. Printing color PDFs (Acrobat Pro)
    6. Printing PDFs in custom sizes
  14. Accessibility, tags, and reflow
    1. Create and verify PDF accessibility
    2. Accessibility features in PDFs
    3. Reading Order tool for PDFs
    4. Reading PDFs with reflow and accessibility features
    5. Edit document structure with the Content and Tags panels
    6. Creating accessible PDFs
    7. Cloud-based auto-tagging
  15. Searching and indexing
    1. Creating PDF indexes
    2. Searching PDFs
  16. Multimedia and 3D models
    1. Add audio, video, and interactive objects to PDFs
    2. Adding 3D models to PDFs (Acrobat Pro)
    3. Displaying 3D models in PDFs
    4. Interacting with 3D models
    5. Measuring 3D objects in PDFs
    6. Setting 3D views in PDFs
    7. Enable 3D content in PDF
    8. Adding multimedia to PDFs
    9. Commenting on 3D designs in PDFs
    10. Playing video, audio, and multimedia formats in PDFs
    11. Add comments to videos
  17. Print production tools (Acrobat Pro)
    1. Print production tools overview
    2. Printer marks and hairlines
    3. Previewing output
    4. Transparency flattening
    5. Color conversion and ink management
    6. Trapping color
  18. Preflight (Acrobat Pro)
    1. PDF/X-, PDF/A-, and PDF/E-compliant files
    2. Preflight profiles
    3. Advanced preflight inspections
    4. Preflight reports
    5. Viewing preflight results, objects, and resources
    6. Output intents in PDFs
    7. Correcting problem areas with the Preflight tool
    8. Automating document analysis with droplets or preflight actions
    9. Analyzing documents with the Preflight tool
    10. Additional checks in the Preflight tool
    11. Preflight libraries
    12. Preflight variables
  19. Color management
    1. Keeping colors consistent
    2. Color settings
    3. Color-managing documents
    4. Working with color profiles
    5. Understanding color management

Get help faster and easier

New user?