Skip to content

Publish a public form

How-to9 minPractitioner

Before you start

A public form lets people outside your workspace send you a record, for example a vendor registration or a service request, without signing in. You publish the form, share a link or a QR code, and each submission arrives as a new record in the module.

  1. Open the Forms tab of the module and click Save at least once. Publish is switched off until the form has been saved.
  2. Decide which fields visitors should not see or change. See the next section.
  3. Click Publish.

The label next to the module name changes from Internal to Public. Internal means “Only signed-in users can use this form”. Public means “Anyone with the link can submit this form”. The toolbar now shows Share, Customize and Unpublish in place of Publish.

Publishing acts at once, whatever else is unsaved.

The public page shows the same blocks and fields as the internal form. For each field you can change that. Click the sliders icon on the field card, and use On the public form:

OptionResult
Same as this formThe field behaves as it does inside
HiddenThe field is not on the public page. The card shows Not on public form
Read-onlyVisitors see the value. The card shows Read-only on public form

Go through every field before you share the link. Anything left as Same as this form is on the page, and lookup fields show their options to visitors.

Click Share. The Share form dialog shows the Shareable link.

The link looks like your-server/published/public-form.xhtml?FORM_KEY=…, with your own server address in front. Add &lang=ar to open the page in Arabic. Without it, or with any other value, the page is in English. See Prefill a form with parameters to fill fields from the link.

Print the QR code on a poster or a delivery note, and the same form opens on a phone.

Click Customize. Customize Public Form opens. Click Save in it to save the settings. This saves the whole form too.

These settings show on the public page:

SettingWhat it does
Disable headerHides the header section
Form title, SubtextThe heading and the line under it
Header sizeSmall, Standard or Large
Text alignmentLeft, Center or Right
Header text color, Header subtext colorColours of the two texts
Header logo, Header logo alignmentAn uploaded logo, placed left, centre or right
Enable header media, Header style type, Header background imageA header image, as Hero or Compact
Background colorThe colour behind the form. Default resets it
Enable footer text, Footer textA line under the form

They see a page that says “Request submitted” and “Thank you for submitting your request.” The record is created in the module, like any other. If a required field is empty, the form asks for it first. The button is labelled Submit, or its Arabic equivalent when the link has lang=ar.

Click Unpublish. Beezr asks “Unpublish this form?” and explains “The public link stops working straight away. You can publish again later.” After you confirm, the label returns to Internal. Anyone who opens the old link sees “Form unavailable”.

  • Share, Customize and On the public form appear once the form is published.
  • Saving the Customize dialog saves the form. Fix any validation errors first.
  • Check the form on a phone. Open the link yourself before you send it.

Check yourself

Layla clicks Unpublish. What happens to the link she shared last week?
Show the answer

It stops working straight away, and she can publish again later. The confirmation says "The public link stops working straight away. You can publish again later." Visitors see Form unavailable.

Where does Omar find the link and QR code of a published form?
Show the answer

Under Share in the toolbar. Share opens the Share form dialog with the Shareable link and the Generate QR code switch.

What's next

Last checked