Pre-filling via UUID is not working

You send a form link containing ?address[ID]=... or ?estate[Id]=... — but the form opens blank instead of loading the data record. Here are the most common causes.

1. `uuid` field not enabled in onOffice

In onOffice Administration, the uuid field must be enabled:

Addresses module: under Master Data
Property module: under Technical Details

Without the uuid field enabled, onOffice cannot provide the UUID and propform cannot search using it.

2. “Pre-fill with UUIDs” in the form settings off

Even if the UUID fields are active in onOffice, you must tick the box for “Pre-fill with UUIDs” in the form settings under “Edit existing records”.

If the box is unchecked, propform rejects the UUID parameter and the form opens blank.

3. Incorrect URL parameter name

The ID parameters are case-sensitive depending on the module:

Module	Correct	Incorrect
Address	`address[ID]`	`address[Id]`, `address[id]`
Property	`estate[Id]`	`estate[ID]`, `estate[id]`
Activity	`agentsLog[id]`	`agentslog[id]`, `agentsLog[Id]`
Task	`task[id]`	`task[ID]`
Date	`calendar[id]`	`calendar[ID]`
Search criterion	`searchcriteria[id]`	`searchcriteria[ID]`

📖 Complete overview of URL parameters: URL parameters

4. API user does not have read access to the record

The propform API user must be permitted to read the record. Common issues:

Record permissions: Read permissions are restricted for the address or property
Private checkbox: The address has the “Private” checkbox ticked — only the user who set it can view it
Group module: The API user is not assigned to a group

📖 Detailed instructions: My form isn’t writing data to onOffice

5. Incorrect UUID used in the onOffice macro

When you create the link in an onOffice email template using macros:

✅ Correct: ?address[ID]=_Uuidaddress&estate[Id]=_Uuidestate
❌ Incorrect: ?address[ID]=_address.Uuid (does not exist)
❌ Incorrect: ?address[ID]=_AdrUUID (does not exist)

The correct macros:

_Uuidaddress — UUID of the linked address
_Uuidestate — UUID of the linked property

6. Record has since been deleted

If the record whose UUID is in the link has already been deleted in onOffice, propform can no longer load it. The form will then open blank.

Test checklist

If nothing works, check the following in this order:

In onOffice: Open the record manually — does it still exist?
In onOffice: Is the uuid field enabled? (Master data for addresses, Technical details for properties)
In propform: Form settings → Is “Pre-fill with UUIDs” ticked?
In the URL parameter: Is the spelling correct? (Note: case-sensitive)
API user: Does the user have read access to the record?

If nothing helps

Please email us at hello@propform.io with the following information:

The full form link with URL parameters (you may anonymise the UUID)
Date & time of the request
Which record should have been loaded?

propform.ioHilfe