Requirement Fields

Requirement fields are custom form questions attached to service products. Customers fill them out after purchasing a service, before the vendor can begin work.

Field Types

Textbox

A single-line text input for short responses. Best for names, URLs, and brief instructions.

Textarea

A multi-line text input for longer responses. Best for project descriptions, detailed instructions, and special requirements.

WYSIWYG Editor

A WordPress TinyMCE rich text editor with a formatting toolbar. Best for detailed briefs with formatting, styled content, and specifications that need headings or lists.

File Upload

A file upload field that lets customers attach files with their requirements. Best for logo files, brand assets, reference images, and source documents.

Dropdown

A single-select dropdown where the customer picks one option. Best for category, language, or format selection.

Multi-Select

A multi-select dropdown (powered by Select2) where the customer chooses multiple options. Best for “select all that apply” scenarios such as features or platforms.

Radio Button

A set of predefined options where the customer selects exactly one. Best for Yes/No questions, service tier selection, and turnaround preference.

Adding Requirement Fields

1. Edit a product with the Service checkbox enabled.
2. Scroll to the Service Requirement Questions meta box.
3. Add a field and choose its type.
4. Enter the question label.
5. For Dropdown, Multi-Select, and Radio Button fields, add the available options.
6. Check Required if the field must be completed.
7. Repeat for additional fields.

Managing Fields

• Reorder - drag and drop fields to change their display order.
• Delete - remove a field.
• Edit - change a field’s label, options, or required status.

Export and Import

Requirement field configurations can be exported from one product and imported into another:

• Export - exports the field definitions as JSON via an AJAX handler.
• Import - imports a previously exported JSON configuration to a different product.

This is useful when creating multiple service products with similar requirement forms.

How Customers See Requirements

After a customer completes checkout for a service:

1. If redirect is enabled and the order contains a single service, they are redirected to the service order page.
2. The requirement form displays all fields configured for the product.
3. Required fields must be completed before the form can be submitted.
4. On submit, the order status changes from Waiting For Requirement to Work In Progress.
5. The vendor receives an email notification with the submitted requirements.

Both the customer and vendor can view submitted requirements on the order detail page, above the conversation area. The vendor also sees requirements in the WooCommerce order admin.

Storage

Data	Where it is stored
Field definitions	Product meta key wbcom_wss_req_ques
Customer responses	Order item meta key wbcom_wss_customer_requirement
File attachments	Meta key woo_sell_attachment