Formvoice Formvoice

URL Parameters Guide

Enhance and customize Formvoice forms with URL parameters for personalization, tracking, and runtime configuration

Quick Navigation:

Introduction Examples Name & Email Custom Values FS_ Parameters URI Encoding Widget Usage

What are URL Parameters?

URL parameters let you enhance Formvoice forms with additional data and customization. Three types are available:

1

Pre-fill Parameters

Personalize forms with name & email

2

Custom Hidden Values

Include any data you need

3

FS_ Parameters

Override form settings at runtime

Example: ?name=John&email=john@example.com&order_id=12345&FS_theme=dark

How Parameters Work

1. Parameter Types

name & email → Pre-fill & personalization
custom_field → Hidden input values
FS_* → Form setting overrides

2. Processing Order

  1. Extract name & email for special handling
  2. Apply FS_ parameters to override form settings
  3. Add remaining parameters as hidden inputs

3. Data Flow

• All non-FS_ parameters included in form submission

• Available for integrations and webhooks

Quick Examples

Simple customization:

https://formvoice.com/myform?FS_title=Contact+Sales

Multiple parameters:

https://formvoice.com/myform?FS_title=Bug+Report&FS_theme=dark&FS_allow_images=true

Disable social options:

https://formvoice.com/myform?FS_whatsapp=__off__&FS_telegram=__off__

Common Use Cases

Context-Specific Forms

Customize placeholder text based on where users come from

Different Use Cases

Enable/disable features based on feedback type or user segment

Campaign Tracking

Use custom success pages with campaign-specific messaging

White-Label Solutions

Customize branding with logos and themes per client

Name & Email Parameters

The name and email parameters are special - they provide personalization and response handling:

Example URL:

https://formvoice.com/myform?name=John+Doe&email=john@example.com
name

Personalizes the greeting

Shows "Hi John!" in the form intro

Included in submission data to identify the sender

email

Pre-fills response email field

Auto-fills the "I'd like a response" email input

Only visible when response checkbox is enabled

Why use these? Name creates a personal connection ("Hi John!") and identifies the submitter. Email enables account matching and follow ups (plus other use cases).

Custom Hidden Values

Any URL parameter that doesn't start with FS_ (except name and email) is automatically added as a hidden input field in your form. You can add as many as you like:

Example URL:

https://formvoice.com/myform?order_id=12345&user_type=premium&campaign=email-2025

Creates hidden inputs:

<input type="hidden" name="order_id" value="12345">
<input type="hidden" name="user_type" value="premium">
<input type="hidden" name="campaign" value="email-2025">

✓ Use for: Order IDs, user segments, campaign tracking, session data

✓ Automatic: No configuration needed - just add to URL or widget data

✓ Secure: Values included in form submission data

URI Encoding Guide

When building URLs with parameters, proper encoding ensures your values work correctly:

Spaces

?FS_title=Contact+Us

Apostrophes & Quotes

?FS_intro_message=We%27d+love!

Special Characters

?email=user%40example.com

JavaScript Helper

const url = baseUrl + '?FS_title=' + encodeURIComponent('We'd love feedback!');
// Result: ?FS_title=We%27d%20love%20feedback!
Always encode user input or dynamic values to prevent URL breaking!

FS_ Parameters Reference

Override form settings at runtime using FS_ prefixed parameters:

Basic Settings

FS_intro_message Welcome text shown at top of form text / __appdefault__
FS_logo_url URL of logo image to display url / __none__
FS_theme DaisyUI theme name theme / __appdefault__

Form Text & Labels

FS_title Main form heading text / __appdefault__
FS_placeholder Textarea placeholder text text / __appdefault__
FS_submit_button_text Submit button label text / __appdefault__
FS_response_text Response checkbox label text / __appdefault__
FS_social_dm_title Social DM section heading text / __appdefault__

Feature Toggles

FS_allow_images Allow image attachments true / false
FS_allow_voice Allow voice recordings true / false
FS_allow_location Allow location sharing true / false
FS_show_response_checkbox Show response request option true / false

Social DM Settings

FS_whatsapp WhatsApp phone number phone / __off__
FS_telegram Telegram username username / __off__
FS_twitter Twitter numeric user ID user_id / __off__

Success Page

FS_on_success_url Redirect URL after submission url / __none__
FS_success_title Success page heading text / __appdefault__
FS_success_message Success page message text / __appdefault__
FS_success_button_text Success button label text / __appdefault__
FS_success_button_url Success button link url / __none__

Special Values:

__appdefault__ - Use Formvoice default

__off__ - Disable (social DM)

__none__ - Clear (URLs)

Widget Implementation

When using the button widget, parameters are passed as data attributes:

<!-- Include widget script once in your page -->
<script src="https://formvoice.com/js/widget.js"></script>
<!-- Feedback button with parameters -->
<a href="https://formvoice.com/myform"
   data-formvoice="true"
   data-FV-name="John Doe"
   data-FV-email="john@example.com"
   data-FV-order_id="12345"
   data-FV-user_type="premium"
   data-FV-FS_title="Contact Us"
   data-FV-FS_theme="dark">
   Send Feedback
</a>
All parameters use the same data-FV- prefix, regardless of type

LLM-Friendly Documentation