10/15/2026

[BUG Report] Designer API: setCustomAttribute("placeholder") on form inputs fails with "reserved attribute name", but the Form Inputs FAQ says it works

Designer Extensions
Developer APIs
Developer Resources

Hi all,

I'm building a Designer Extension that adds a form to a page. I need to set or clear the placeholder on the form inputs, so users don't see "Example Text".

The Form Inputs reference has an FAQ, "Can I set placeholder text on a form input field?", which says yes and gives this code:

const el = await webflow.getSelectedElement()
const input = await el.append(webflow.elementPresets.FormTextInput);
await input.setCustomAttribute("placeholder", "Enter your email");

Page: https://developers.webflow.com/designer/reference/form-inputs

In the Designer today, this fails.

Steps:

1. Select a Form element (type FormForm) on the canvas.

2. Run the code above from a Designer Extension.

What happens:

  • append works and returns a FormTextInput.

  • setCustomAttribute throws: "placeholder" is a reserved attribute name

  • getCustomAttribute("placeholder") returns null.

  • The new field shows "Example Text".

I get the same result with FormTextarea, and with FormTextInput after setInputType("email").

Other routes I tried also fail:

  • setAttribute("placeholder", ...) throws: attributes[0]: "placeholder" is a reserved attribute name

  • Passing a placeholder setting when the element is created: Setting "placeholder" is not applicable to this element

  • searchSettings and getSettings have no placeholder key. The keys are domId, visibility, name, required, type and attributes.

  • getWHTML and insertElementFromWHTML are undefined in the Designer.

The Placeholder box in the Text Field settings panel works by hand, so the setting exists. I just can't reach it from the API.

Setup: Designer Extension in development mode ("Launch development App"), @webflow/designer-extension-typings 2.2.2, Chrome on macOS, tested on 15 October 2026.

My questions:

1. Is there a supported way for an app to set or clear a form input's placeholder?
2. If not, could the FAQ be updated? And is a placeholder method planned, like setName and setRequired?

For now, we take the inputs from a fresh FormForm preset, which has an empty placeholder, and move them into place. That doesn't help for textareas, because the preset has none.

Thanks!

10/15/2026
Unresolved