Global Custom Options

VIDEO WALKTHROUGH

Global Custom Options: setup guide

2:35

Recorded on version 1.0.2 · Narrated walkthrough · English captions

Jump to a chapter 8 chapters

1. 0:00Set up Global Custom Options
2. 0:13Open the module workspace
3. 0:33Open reusable option templates
4. 0:52Build the option set
5. 1:14Assign products and an apply mode
6. 1:31Check the native product options
7. 1:51Save and verify your setup
8. 2:12Your setup checklist

Read the full video transcript

Global Custom Options 1.0.2 — Magento Admin setup

00:00:00 — Set up Global Custom Options
Welcome to the Agentic Ecom Global Custom Options Admin guide. We'll walk through the main setup screens and the checks to make before using the module. This guide assumes the extension is already installed.

00:00:13 — Open the module workspace
Start in Magento Admin and open the Global Custom Options workspace. Use an Admin role with the required permissions. We'll review the setup controls without running bulk changes. Keep a staging backup and prepare a small, representative example before applying a workflow to live catalogue data.

00:00:33 — Open reusable option templates
Open Catalog, Inventory, Global Custom Options. Add New Template creates a reusable option set; Import From S K U can start from a product that already has native options. Choose a clear template name and a stable identifier so the template remains easy to manage later.

00:00:52 — Build the option set
In Template Details, enter the name, identifier and status. In Custom Options, add each option with its title, type, required setting and pricing. Selectable types use a separate values table for each choice. The pipe-separated text format belongs to C S V imports, not to the Admin values table.

00:01:14 — Assign products and an apply mode
Open Assign to Products and review Apply Mode before selecting products. Replace, Update and Add have different effects on native product options. Choose a small staging selection and confirm which existing options should remain before using Save Template and Sync.

00:01:31 — Check the native product options
After a deliberate sync, reopen a selected product's Customizable Options and check the written options, prices and choices. Test the product and cart flow in staging. The template writes native Magento options, so a headless storefront still needs its normal product-option and checkout integration.

00:01:51 — Save and verify your setup
When your required settings are complete, use the screen's Save control and wait for Magento's confirmation. Then reopen the record or configuration and check the saved values at the intended scope. If the storefront still shows earlier settings, refresh the relevant caches. Test your own configuration before using it with customers.

00:02:12 — Your setup checklist
That's the Admin setup walkthrough for Global Custom Options. Check permissions and scope, review the module-specific settings, then save and verify a small staging example. Use the written guide at user guides dot Agentic Ecom dot net for installation details, complete field references and any separate storefront integration steps.

Download videoEnglish captionsDownload transcript

Magento’s native custom options are defined per product, so a “Gift Wrap” or “Engraving” option has to be rebuilt by hand on every product that needs it — and changing it later means editing each product again.

Global Custom Options 1.0.2 lets you build an option set once as a template, assign it to as many products as you like, and the module writes those options onto each product as real Magento custom options. Templates can be translated per store view, imported from a product that already has options, and bulk-managed by CSV.

Install

The Composer commands below are for a direct AgenticEcom purchase. If you bought this extension through Adobe Commerce Marketplace, use the purchased Composer package from repo.magento.com with Adobe Marketplace access keys; see Getting Started. A Marketplace purchase should not require a second AgenticEcom direct-store licence.

Install Global Custom Options with Composer using your AgenticEcom licence key (find it on your My Licences page — one key unlocks every module you own):

# 1. Register the AgenticEcom repository (once per store)
composer config repositories.agenticecom composer https://repo.agenticecom.net
composer config --global --auth http-basic.repo.agenticecom.net <YOUR-LICENCE-KEY> x

# 2. Require this module
composer require agenticecom/module-custom-options

# 3. Apply it
php bin/magento setup:upgrade && php bin/magento setup:di:compile && php bin/magento cache:flush

Have the whole platform?

Install every module in one command with composer require agenticecom/suite — see Install the complete suite.

Compatibility

Magento

QA baseline: Open Source 2.4.9. Check release notes for other versions.

PHP

Project QA baseline: 8.5.10; check this module’s release notes.

Storefront

Writes native product custom options. The Luma product and cart flow was tested on Magento Open Source 2.4.9; headless storefronts need their own option and checkout integration.

Templates

Apply one template to selected products with Replace, Update or Add.

Native options under the hood

A template doesn’t add a parallel option system — it writes standard Magento custom options onto each assigned product. So the storefront, cart, checkout, order, PDF and the catalog GraphQL/REST APIs all see them exactly like hand-built options. Nothing on the frontend needs to know this module exists.

Quick start

1. Go to Catalog → Inventory → Global Custom Options and click Add New Template (or Import From SKU to seed one from a product that already has options).

2. Build your options in the Custom Options section (one row per option).

3. Open Assign to Products, pick an Apply Mode, and tick the products.

4. Click Save Template & Sync — the options are written to every assigned product.

Building a template

The template edit screen has four sections:

Template Details

Field	What it does
Template Name	Human label for the template (e.g. Engraving & Personalisation).
Identifier	Unique code used as the CSV upsert key. Leave blank to auto-generate from the name (lowercase, numbers, underscores).
Status	Enable/disable the template.

Custom Options

Add one row per option. Each row has a Title, a Type, Required toggle, Price, Price Type, SKU, Sort Order, and — for select types — a Values table where you add each choice as its own row (exactly like Magento’s native Customizable Options on a product).

Option types

• Text Field, Text Area — free text (use the row’s own Price).
• Dropdown, Radio Buttons, Checkbox, Multiple Select — selectable types; each expands into a Values table (click Add Value per choice).
• Date, Date & Time, Time — date/time pickers.
• File Upload — customer file attachment.

Adding values (select types)

For Dropdown / Radio / Checkbox / Multiple Select, the option expands into a Values table. Click Add Value for each choice and fill its columns: Title, Price, Price Type, SKU and Sort Order.

Note

The Label | price | price_type pipe format is only used inside the CSV import file (see the Import section below) — not in the admin form, which uses the table above.

Price type

Fixed — a flat amount added to the price. Percent — a percentage of the product price. Applies to both option-level and value-level prices.

Assign to Products

Pick an Apply Mode, then tick the products this template should be written to. On Save Template & Sync, the options are pushed to every selected product.

Replace

Replace — refresh the options this template previously created on the product. Merchant-created options and options from other templates remain in place.

Update

Update — refresh matching option positions owned by this template and add new positions. It does not match by title or change options owned by someone else.

Add

Add — write only template positions that have not already been applied by this template. Existing owned, merchant-created and other-template options remain in place.

Check products after upgrading

Version 1.0.2 tracks newly applied options by template and product. Options applied by an earlier version have no ownership record, so the first sync leaves them in place and can add a second copy. Review a representative product before syncing many previously assigned products. Removing an assignment stops future syncs but does not remove options already applied to that product.

Per-Store Label Overrides

Translate option and value labels per store view without leaving the template. Add one row per language in Option Title Translations and Option Value Translations:

Column	Meaning
Default Title	The option/value title exactly as typed in the builder — used to match the override.
Store Locale	The store-view language the override applies to (e.g. de_DE).
Override Title	The translated label written for that store view.

How translations are applied

On sync, the default-scope labels are written first, then for each override the module writes a store-view-scoped label row for the matching option/value. Locales resolve to every store view configured for that language, so one de_DE override covers all your German stores. Anything without an override falls back to the default label.

Import options from a product

Already have a product with the perfect option set? Turn it into a reusable template in one step. Catalog → Global Custom Options → Import From SKU:

1. Enter the Product SKU that already has custom options.
2. Give the New Template Name.
3. Click Run Import — the product’s options are read into a new template you can then edit and assign elsewhere.

CSV import / export

Bulk-create and bulk-edit templates in a spreadsheet. Import CSV and Export CSV are on the grid toolbar.

The CSV is flat/long — one row per option value (or per option for single-value types), grouped by the code column:

code,name,is_active,option_title,option_type,option_required,option_price,option_price_type,option_sku,option_sort,value_title,value_price,value_price_type,value_sku,value_sort,option_key
gift_options,Gift Options,1,Gift Wrap,checkbox,0,2.5,fixed,,10,Standard,2.5,fixed,,1,option_1
gift_options,Gift Options,1,Gift Wrap,checkbox,0,2.5,fixed,,10,Premium,5,fixed,,2,option_1
gift_options,Gift Options,1,Engraving Text,field,0,10,fixed,,20,,,,,,option_2

Import behaviours

• Add / Update — create new templates and overwrite any whose code matches.
• Add Only — create new templates only; existing codes are skipped and reported.

Round-trip

Export CSV produces this format, so export, edit and re-import. Templates are matched on code. Keep option_key for each option; rows sharing a key form one selectable option, while distinct keys preserve options with the same title. Legacy CSV without option_key still imports, but groups rows by title.

Grid management

The templates grid supports search, column controls, paging and mass actions — Enable, Disable and Delete selected templates. The Assigned Products column shows how many products each template is currently written to.

CSV import creates or updates template definitions; open and save an imported template to apply it to selected products. The importer rejects empty or duplicate headers and rows with the wrong number of columns before changing any templates. Individual database errors are reported per template. Upload a .csv file of no more than 5 MB.

Configuration

No separate Stores → Configuration switch is required. Manage templates under Catalog → Inventory → Global Custom Options.

FAQ

Do customers see a new kind of option on the storefront?

No — the module writes standard Magento custom options onto each product, so the storefront, cart, checkout and order behave exactly as they would with hand-built options. The template system is purely an admin-side authoring tool.

What’s the difference between Replace, Update and Add?

Replace refreshes only options owned by that template; Update refreshes matching owned positions and adds new positions; Add writes positions the template has not yet applied. Merchant and other-template options remain in place. Pick a mode in Apply Mode.

Can one template be different per language?

Yes. Use Per-Store Label Overrides to give option and value titles a translated label per store-view locale. The default label is the fallback for any store view without an override.

I already built options on a product — can I reuse them?

Yes — Import From SKU reads an existing product’s custom options into a new template you can then assign to other products.

How do I move templates between environments?

Export CSV on one store and Import CSV on another. Templates are matched and upserted on the code column, so re-importing updates rather than duplicates.

Is it secure?

Admin actions use Magento permissions. CSV structure is validated before import, and template sync uses a per-product transaction. Check the release notes for tested Magento and PHP versions.

Release and support

Version 1.0.2 was installed through Composer and tested on Magento Open Source 2.4.9 with PHP 8.5.10, including template sync, CSV round trips, Luma product pages and cart. Other editions, versions and custom themes require separate qualification. A one-time purchase includes 12 months of updates and support. Renewal is optional and never automatic; purchased versions remain usable after support ends. See the AgenticEcom licence and your order terms.