SuiteCommerce: Gift Certificate Groups Mimic Matrix Items on PLP/PDP

What changed

A new Gift Certificate Group record type and several supporting fields let you bundle multiple gift certificate items so they render like a matrix item on your SuiteCommerce storefront. Instead of listing every denomination individually on the Product Listing Page (PLP), one representative gift certificate displays per group. On the Product Detail Page (PDP), all certificates in the group appear as selectable item options.

New record

• Gift Certificate Group — created inline from the Item record at SuiteCommerce Extensions > Gift Certificate Advanced > Gift Certificate Group > New. The Name field becomes the display name on the PLP.

New fields on the Item record

Located on the SuiteCommerce Extensions tab > Gift Certificate Advanced subtab:

• Item Options Button Label — label for each item-option button on the PDP. Supports [[name]] and [[price]] placeholders. Overrides the same field set at the SC Configuration level. Price placeholder is suppressed when Require Login for Pricing is enabled on the Web Site Setup record.
• Only Show in Product Detail Page — hides the certificate from the PLP, search results, and facet results. Use this for every certificate in a group except the one you want visible on the PLP.
• Gift Certificate Group — associates the certificate with a group.

New SC Configuration fields

Found at Commerce > Websites > Configuration > Extensions > Gift Certificate Advanced > Gift Certificate Item Options:

• Group Certificates as Item Options — master toggle for the grouping feature.
• Item Options Title - Gift Certificates — heading text above item options on PDP.
• Show Image Options Swatch — enables image swatches for the item options.
• Item Options Button Label - Gift Certificates — default button label (overridable per item). Same [[name]]/[[price]] placeholders.
• Hide Inventory Types from Facets — suppresses the auto-generated Inventory Type facet that the extension adds.
• Price Range — PLP label template for the group; supports [[minPrice]] and [[maxPrice]] placeholders.

Field set requirements

Two fields must be added to both the details and Search field sets on the Web Site Setup record:

1. Item Options Button Label
2. Gift Certificate Group ID

Without these field-set entries, the storefront templates will not receive the data needed to render groups.

Facet requirements

Three facet fields must be selected on the Web Site Setup record:

1. Type
2. Only Show in Product Detail Page
3. Gift Certificate Group ID

What to do

1. Enable the feature — Open the SC Configuration record for your site (Commerce > Websites > Configuration), navigate to Extensions > Gift Certificate Advanced, and check Group Certificates as Item Options. Configure the remaining label/swatch fields as needed.
2. Update field sets — On the Web Site Setup record (Commerce > Websites > Website List > Edit), go to the Field Sets subtab. Add Item Options Button Label and Gift Certificate Group ID to both the details and Search field sets.
3. Add facet fields — On the same Web Site Setup record, add the three required facet fields (Type, Only Show in Product Detail Page, Gift Certificate Group ID) per the standard facet-selection workflow.
4. Create groups — Edit any gift certificate item, go to SuiteCommerce Extensions > Gift Certificate Advanced, and click New next to the Gift Certificate Group field to create a group record. The Name value appears on the PLP.
5. Assign items to groups — For each gift certificate, set the Gift Certificate Group field. For every certificate in the group except the one you want visible on the PLP, check Only Show in Product Detail Page. Optionally set a per-item Item Options Button Label to override the global default.
6. Verify — Confirm the PLP shows a single entry per group with the group name and price-range label, and that clicking through to the PDP presents all grouped certificates as selectable item options.

Caveats

• The source documentation does not specify a NetSuite release version. Verify which release introduced the Gift Certificate Management extension in your account by checking Customization > SuiteBundler > Search & Install Bundles or the SuiteCommerce Extension Manager.
• If Require Login for Pricing is enabled, price-related placeholders ([[price]], [[minPrice]], [[maxPrice]]) will be suppressed for unauthenticated visitors. Test both logged-in and anonymous scenarios.
• The Web Store Display Name field on the Gift Certificate record (under Web Store > Web Store Display) controls the individual certificate name on the PDP — this is distinct from the group Name shown on the PLP.