How to Add Rating and QR Code Fields to Forms
Two field types make portal forms quicker to fill in. A rating field shows stars or thumbs that portal users select instead of typing a number. A barcode or QR code field adds a camera button, so portal users can scan a code instead of typing it, which cuts typing errors.
Before you start
- You need admin access to the CRMJetty admin portal.
- The form must already exist. See How to Create a Portal Form for Any CRM Entity.
- A field can be a rating field or a scan field, not both.
Field types each feature supports
| Feature | Data types | Form types |
|---|---|---|
| Rating | Integer, BigInt, Decimal, Double | Add, Edit, Detail |
| Barcode/QR code | String, Integer, Decimal, BigInt | Add, Edit, Detail |
Add a rating field
- Go to Design → Form Builder.
- Select Edit on the form.
- Select the Settings icon on a number field. The Field Configuration panel opens.
- Select Enable Rating.
- In the icon picker, choose the icon, such as stars or thumbs.
- In the color picker, choose the icon color.
- Optional: select Read Only so portal users can see the rating but not change it.
- Select Save, then publish the form.


Ratings go up to 5. You can’t change the maximum.
Note: A Read Only rating field shows only its default value. If the field has no default value, it is saved empty.
What portal users see
Portal users select the icons to give a rating. They can give whole or half ratings, such as 2, 4.5 or 1.5. The icons appear in the icon and color you chose.
You can also show ratings in lists and data cards. See How to Show CRM Records as Cards in the Portal.
Add a barcode or QR code field
- In Design → Form Builder, select Edit on the form.
- Select the Settings icon on the field. The Field Configuration panel opens.
- Enable Barcode/QR Code Input.
- Decide whether portal users can also type the value, and set Enable Input Text. See the table below.
- Select Save, then publish the form.
| Enable Input Text | Portal users can |
|---|---|
| Checked | Scan a code or type the value. |
| Not checked | Only scan a code. The field is read-only for typing. |
What portal users see
A camera icon appears in the field. Portal users select it to turn on their device camera and scan the code. The scanned value fills the field. The browser asks the portal user for permission to use the camera the first time.
Supported code formats
QR Code, AZTEC, CODE_39, CODE_93, CODE_128, ITF, EAN_13, EAN_8, PDF_417, UPC_A, UPC_E, DATA_MATRIX, MAXICODE, RSS_14 and RSS_EXPANDED.
Troubleshooting
Enable Rating or Barcode/QR Code Input is missing: Check the field’s data type against the table above. Also check that the other option isn’t already on; a field can’t use both.
The camera doesn’t open: The portal user must allow camera access in the browser. If they blocked it, they need to allow it in the browser’s site settings and reload the page.
Related articles
- How to Add Regex Validation to Form Fields
- How to Show CRM Records as Cards in the Portal
- How to Design Add, Edit and Detail Form Layouts