formbasedocs
Naar de appApp

Formulieren bouwen

Verborgen velden

Voeg onzichtbare metadata toe aan elke inzending — verkeersbronnen, CRM-ID’s, verwijzingscodes of andere context die je al over de respondent weet. Verborgen velden leggen gegevens vast via URL-parameters zonder iets op het formulier te tonen.


Waarom verborgen velden gebruiken?

Formulieren hebben vaak context nodig die de respondent zelf niet kan (of mag) opgeven. Verborgen velden lossen dit op door je toe te staan metadata via de URL aan elke inzending te koppelen. Dit is handig als je al iets over de respondent weet voordat ze het formulier openen — waar ze vandaan komen, wie hen heeft doorverwezen, of bij welk record ze horen in jouw systeem.

  • Verkeersbronnen bijhouden — weet of een inzending afkomstig is van een e-mailcampagne, een social media-post of je website

  • Verbinden met je CRM — geef een contact-ID, deal-ID of account-ID door zodat de inzending teruggekoppeld wordt aan het juiste record

  • Opvolging personaliseren — leg een naam of e-mailadres vast dat je al hebt, en gebruik dit in conditionele logica of e-mailmeldingen

  • Workflows met meerdere formulieren — geef gegevens van het ene formulier door aan het volgende, zodat respondenten zich niet hoeven te herhalen

  • A/B-testen — tag elke inzending met de variant of het experiment dat de respondent heeft gezien

Een verborgen veld toevoegen

Typ / op een lege regel en kies Verborgen veld uit de categorie Lay-out. Het werkt alleen op het hoogste niveau van het formulier — niet in een kolom of een herhalende groep. Elk verborgen veld heeft twee instellingen:

  • Veldtype — sla een getal of tekstwaarde op (standaard tekst)

  • Parameternaam — de URL-parameter die dit veld vult (bijv. utm_source, contact_id). Dit is ook de sleutel van dit veld: het is wat een aanroeper verstuurt en waaronder het antwoord terugkomt. Zie Veldsleutels

URL-parameter voorinvullen

Een parameternaam moet URL-veilig zijn zoals geschreven: letters, cijfers en - _ . ~ ! * ’ ( ) zijn veilig. Schrijf spaties en andere speciale tekens percent-encoded, bijvoorbeeld recipient%20name. Een lege, ongeldige of dubbele parameternaam is een publicatiefout — de publicatie-indicator in de werkbalk markeert het en publiceren stopt totdat je het oplost.

Wanneer een respondent je formulier opent met een overeenkomende parameter in de URL, legt het verborgen veld die waarde automatisch vast. Als de parameternaam van je verborgen veld bijvoorbeeld utm_source is, stelt de onderstaande URL het veld in op newsletter.

https://form.formbase.so/abc123?utm_source=newsletter

Je kunt meerdere verborgen velden tegelijk doorgeven:

https://form.formbase.so/abc123?utm_source=newsletter&utm_medium=email&contact_id=12345
  • Waarden worden één keer gelezen, bij het openen van het formulier.
  • Een lege parameter (?utm_source=) laat het veld leeg.

  • Een numeriek verborgen veld negeert waarden die geen getal zijn, dus ?score=abc laat het leeg.

  • Aanvraaglinks negeren URL-parameters. Verborgen velden krijgen daar hun waarden in plaats daarvan uit de context van de aanvraag.

Op een deellink: wil je een URL-waarde tonen in een zichtbaar veld dat de respondent kan bewerken — bijvoorbeeld om een naam vooraf in te vullen — maak dan het verborgen veld de standaardwaarde van het veld door @ te typen. Zie Standaardwaarden van andere velden.

Aanvragen hebben geen verborgen veld nodig om vooraf in te vullen

De hierboven beschreven techniek van verborgen veld plus @ bestaat omdat een deellink maar één ingang heeft: de URL. Iedereen kan een URL bewerken, dus een deellink kan een waarde alleen via een parameter meegeven, en een verborgen veld vangt die op.

Een aanvraag heeft een tweede, afgeschermde ingang. De aanroeper stelt de antwoorden in bij het aanmaken van de aanvraag, aan de serverkant, zodat een aanvraag een zichtbare vraag rechtstreeks vooraf kan invullen — zonder verborgen veld en zonder @-standaardwaarde. De ontvanger opent het formulier met het antwoord al ingevuld.

  • prefill

    — beginantwoorden voor zichtbare vragen, aangeduid via de veldsleutel. De ontvanger ziet ze en kan ze wijzigen.

  • readonly

    — de subset van die vooraf ingevulde sleutels die de ontvanger mag lezen maar niet bewerken.

  • context

    — waarden voor verborgen velden, die de ontvanger nooit ziet.

Die scheiding wordt afgedwongen. De sleutel van een zichtbare vraag meesturen in context wordt geweigerd, met een melding dat je hem in prefill moet sturen, en andersom wordt ook geweigerd. Voeg dus een verborgen veld toe wanneer je gegevens wilt meesturen die je niet wilt tonen, niet alleen om iets vooraf in te vullen.

Veelgebruikte instellingen

  • UTM-tracking — maak verborgen velden aan met de namen utm_source, utm_medium en utm_campaign. Het formulier vangt ze automatisch op uit de URL, en elke waarde wordt opgeslagen als inzendingskolom. Het diagram Verkeersbronnen in Analytics leest utm_source en utm_medium op zichzelf uit de URL, met of zonder verborgen velden. Stel standaardwaarden per link in via het Deeldialoogvenster.

  • CRM-integratie — geef een contact- of deal-ID door vanuit tools zoals HubSpot, ActiveCampaign of Mailchimp. Wanneer inzendingen binnenkomen in je integraties, koppelt het ID alles aan elkaar.

  • Verwijzingsattributie — elke partner krijgt een unieke link met hun code in de URL. Je ziet precies wie elke inzending heeft gegenereerd.

  • Vooringevulde context — geef een klantnaam of plantier door aan een ondersteuningsformulier. Gebruik dit in conditionele logica om verschillende vragen te tonen, of geef het door aan de bedankpagina.

  • Vooringevulde antwoorden — stuur ?email=jane@example.com vanuit je e-mailtool en maak dat verborgen veld de standaardwaarde van de Email-vraag van het formulier. De respondent ziet zijn adres al ingevuld en corrigeert het alleen als het onjuist is.

Werkt met elke linktool

E-mailplatformen (Mailchimp, ActiveCampaign, HubSpot), advertentieplatformen (Google Ads, Meta) en linkverkorters laten je allemaal URL-parameters toevoegen. Verborgen velden vangen ze op zonder extra instellingen aan de formulierzijde.

Gegevens van verborgen velden bekijken

In de inzendingentabel worden verborgen velden weergegeven als eigen kolommen — formbase markeert ze met een oog-doorgestreept pictogram zodat je ze kunt onderscheiden van zichtbare vragen. Ze verschijnen ook in exports, integraties (Google Sheets, webhooks, enz.) en het detailpaneel van inzendingen.

UTM in analytics vs. inzendingen

formbase registreert utm_source, utm_medium en utm_campaign bij de analytics van elk bezoek, en het diagram Verkeersbronnen groepeert inzendingen op bron en medium, maar het slaat ze niet op bij elke reactie. Om de waarde van een parameter per inzending te zien, voeg je een verborgen veld met die naam toe (bijv. utm_source). Het verschijnt dan zowel in de inzendingentabel als in analytics.

Verborgen velden gebruiken met logica

Verborgen velden werken als conditiebronnen in conditionele logica. Een logica-regel kan de waarde van een verborgen veld lezen en vertakken — door verschillende vragen te tonen, naar een pagina te springen, of een berekend veld bij te werken.

Bijvoorbeeld: geef ?plan=enterprise via de URL door. Een logica-regel controleert of het verborgen veld “plan” gelijk is aan “enterprise” en springt naar een specifieke pagina met enterprise-vragen.

Volgende stappen