User Guide

📖 Table of Contents

Welcome to SmarkForm-Powered Forms

Welcome! You’re about to fill out a form powered by SmarkForm, a technology designed to make form filling faster, easier, and more intuitive.

This guide will help you discover powerful features like keyboard shortcuts, smart navigation, and dynamic lists that will save you time and make the experience more pleasant.

New to SmarkForm? Don’t worry! These forms work just like regular forms, but with helpful enhancements. You can use them normally, or speed things up with the tips below.

Keyboard Navigation

SmarkForm-powered forms offer smooth keyboard navigation that helps you move through forms quickly and efficiently.

Use Enter and Shift+Enter to jump directly between form fields:

  • Enter ⏎ — Move to the next field
  • Shift+Enter ⇧⏎ — Move to the previous field

This navigation is smart: it skips over buttons and other non-field elements, taking you straight to where you need to enter information.

Demonstration of Enter key navigation jumping between form fields, skipping buttons
Using Enter to navigate between fields (skips buttons and other non-field elements)

Pro tip: This is much faster than using the mouse or tabbing through every element on the page!

If you need to navigate through all elements (including buttons and links), use the standard Tab key:

  • Tab â†č — Move to the next element (fields, buttons, links)
  • Shift+Tab ⇧â†č — Move to the previous element

Working with Multiline Text

In multiline text areas (textarea fields), pressing Enter adds a new line within the textarea as usual. To move to the next field instead, use:

  • Ctrl+Enter (or Cmd+Enter on Mac) — Move to the next field from a multiline text area
  • Ctrl+Shift+Enter (or Cmd+Shift+Enter on Mac) — Move to the previous field from a multiline text area

Pro tip: You can consistently use Ctrl+Enter and Ctrl+Shift+Enter to navigate through fields from anywhere, regardless of field type!

Discovering and Using Hotkeys

One of SmarkForm’s most powerful features is context-aware keyboard shortcuts (hotkeys) that let you perform actions without reaching for your mouse.

How to Discover Available Shortcuts

To see which keyboard shortcuts are available at any moment:

Press and hold the Ctrl key (or Cmd on Mac) ⌚

While holding Ctrl, you’ll see visual hints appear next to buttons showing their keyboard shortcuts. Release Ctrl to hide the hints.

Screenshot showing hotkey hints appearing on buttons when Ctrl key is pressed
Holding Ctrl reveals hotkey hints next to action buttons

Try it now! If you’re filling out a form, hold down Ctrl to see what shortcuts are available.

SmarkForm’s Unique Hotkey Approach

SmarkForm uses an intelligent, context-aware hotkey system that makes forms intuitive and efficient:

The same hotkey can be used in different parts of the form. For example, many forms use + to add items and − to remove items. If your form has multiple lists (like a list of contacts, each with their own list of phone numbers), the same + hotkey can be used for all of them without conflicts.

SmarkForm automatically picks the right action based on context. When you press a hotkey, SmarkForm triggers the action that’s most relevant to where you’re currently focused in the form. If you’re focused on a phone number field, Ctrl+Plus adds a new phone number. The system always chooses the nearest action to your current position.

This context-aware behavior means you can learn just a few simple hotkeys (like +, −, and Delete) and use them throughout the entire form in a natural, intuitive way.

Example form showing a contact list where each contact has a phone number list, demonstrating context-aware hotkey behavior
Example: Same + hotkey works in different contexts (adding contacts vs adding phone numbers)

Example: Imagine filling out a contact list where each contact has their own list of phone numbers. When you’re focused on a phone field, Ctrl+Plus adds another phone number to that contact. The same hotkey is reused naturally across different contexts!

Second-Level Hotkeys: Reaching Outer Contexts

Sometimes you need to access an action in an outer context. For instance, while filling in a phone number, you might want to add a new contact (outer context) rather than another phone number (current context).

To access second-level hotkeys, hold Ctrl+Alt together (or Cmd+Alt on Mac).

This reveals hotkeys from the next level up in the form hierarchy. In our contact list example:

  • Ctrl+Plus adds a phone number to the current contact (first level)
  • Ctrl+Alt+Plus adds a new contact to the list (second level)

This two-level system keeps the interface clean while giving you keyboard access to everything.

Side-by-side comparison showing Ctrl revealing first-level hotkeys (phone numbers) and Ctrl+Alt revealing second-level hotkeys (contacts)
First level (Ctrl): hotkeys for current context; Second level (Ctrl+Alt): hotkeys for outer context

Try it: Hold Ctrl to see nearby actions, then also hold Alt to reveal actions from the outer context. It’s more intuitive in practice than in words!

Common Hotkey Patterns

While the actual hotkeys available depend on how each form is configured, here are some patterns you’ll frequently encounter:

  • Plus (+) — Add a new item to a list
  • Minus (−) — Remove the current item from a list
  • Delete — Clear or delete a value
  • D — Duplicate an item (when available)

Remember: hold Ctrl to discover what’s available in any specific form. The hints will show you exactly which shortcuts you can use. Also, holding Ctrl+Alt may reveal additional shortcuts for the same keys from the outer context.

Working with Lists

Many forms include dynamic lists where you can add, remove, or reorder items.

Adding and Removing Items

Look for buttons with plus (+) or minus (−) icons, or use hotkeys if configured:

  • Click the + button or use its hotkey (often Ctrl+Plus) — Add a new item
  • Click the − button or use its hotkey (often Ctrl+Minus) — Remove the current item
Dynamic list showing add and remove buttons with their associated hotkey hints
Adding and removing items from a list using buttons (or their hotkeys)

Finding hotkeys: Hold Ctrl to see which keyboard shortcuts are available for the specific form you’re using. The actual hotkeys depend on how the form was designed.

Empty items: SmarkForm often creates a new empty item automatically when you start filling in the last one, so you can keep adding data smoothly.

Reordering Items

Some forms allow you to reorder list items by dragging and dropping:

  1. Click and hold on an item (usually by a drag handle or the item itself)
  2. Drag it to the new position
  3. Release to drop it in place
List items being reordered through drag-and-drop interaction
Drag and drop to reorder list items

Note: Not all lists allow for reordering. This feature is enabled based on the specific use case and requirements of each form.

Understanding List Limits

Some lists have minimum or maximum limits for a reason:

  • Minimum limit: At least this many items are required. You won’t be able to remove items below this minimum. The default is 1, but it can be 0. You’ll notice that the “Remove” button becomes disabled when you reach the minimum limit.
  • Maximum limit: No more items are allowed beyond this number. The “Add” button becomes disabled when the limit is reached.

These limits are intentional constraints based on the form’s requirements. When a button is disabled, it means you’ve reached a limit — you can still modify existing items, but cannot add more or remove required ones. You can be presented with an empty item to fill in because it is expected to usually be at least 1 item, but you can remove it if the minimum is 0. If you just leave the fields blank, validation could fail. If you remove the item, it is more intentional -you are explicitly saying “There is no such item”. This way the validation can be more accurate and helpful.

Add button shown as disabled when maximum list limit is reached
Button becomes disabled when list limit is reached

Working with Nested Sections

Some forms have sections nested within other sections (like contact details within a contact, or items within an order). From your perspective as a user, these work seamlessly:

  • Navigate through them using Enter/Shift+Enter just like the rest of the form
  • Hotkeys work within their context (see Discovering and Using Hotkeys above)
  • When you reach the end of a nested section, pressing Enter typically moves you to the next field in the parent section

Pro tip: You don’t need to think about the form’s internal structure — just navigate naturally and SmarkForm handles the rest!

Accessibility Features

SmarkForm is designed with accessibility in mind, though we’re continuously working to improve:

  • Mouse and touch support: All essential actions have visible buttons that are reachable by mouse or touch. You never need a keyboard shortcut to perform a required task.
  • Full keyboard support: Everything can also be done without a mouse — keyboard navigation and Tab ordering work throughout.
  • Power-user hotkeys: Some non-essential, “power-user” actions may be available only as hotkeys (using hidden trigger buttons). These are still fully discoverable via the Ctrl reveal mechanism: hold Ctrl to see the available hotkeys at any time, even if no visible button is present.
  • Smart tab order: Disabled elements are automatically excluded from navigation, so Tab always moves you to an element you can actually interact with.
  • Context-aware focus tracking: When you add a new list item, SmarkForm automatically focuses the first field of the new item and (if autoscroll is enabled) scrolls it into view, so you never lose your place.
  • Enter key navigation: Pressing Enter / Shift + Enter moves between fields, skipping buttons and other non-field elements.
  • Semantic HTML: SmarkForm is markup-agnostic but encourages developers to use semantic HTML elements. It also provides ARIA labels for complex field types (like lists) so that assistive technologies can understand the structure and purpose of the form.
  • Smart button states: SmarkForm automatically sets the disabled property on trigger buttons when their action is not available (e.g., when a list has reached its minimum or maximum items). The visual styling of disabled buttons is the developer’s responsibility via CSS.

Using assistive technologies? We’re committed to making SmarkForm accessible to everyone. If you encounter any accessibility issues, please report them so we can continue improving!

Tips for Efficient Form Filling

Here are some tips to make form filling even faster:

  1. Learn the discovery shortcut — Hold Ctrl to see available hotkeys anytime you’re unsure what actions are available

  2. Use Enter to navigate — It’s faster than Tab for moving between fields, and it skips non-field elements

  3. Master a few common hotkeys — Once you learn hotkeys for common actions (like adding/removing list items), you can use them throughout the form

  4. Try second-level hotkeys — Hold Ctrl+Alt to access outer context actions when working with nested structures

  5. Watch for smart features — Notice how buttons disable themselves when limits are reached, or how new list items appear automatically. Lists of complex forms may provide a button to duplicate an item (huge time saver sometimes), etc


  6. Use the keyboard for everything — Once you’re comfortable with navigation and hotkeys, you can often complete entire forms without touching your mouse

  7. Context-aware shortcuts are a feature — The same hotkey doing different things in different sections is intentional and makes the interface more intuitive

🎯 Want to see SmarkForm in action? Check out the Examples section to explore interactive demonstrations of all these features.

đŸ’» Are you a developer? See the Showcase section for in-depth examples with code, or visit the Branding page to learn how to link to this guide from your own forms.

This guide covers the core user-facing features of SmarkForm-powered forms. The specific features available in any given form depend on how the developer has implemented it.

Questions or issues? Visit the Support page to get help.

Resources
SmarkForm Forms — Agent Knowledge
Resources
SmarkForm Usage — Agent Knowledge