// Magento 2 Extension

Ayasoftware Colorguide

Sell configurable products with thousands of option combinations — brand, colour, size — without the slowdown of native Magento custom options. A fast swatch picker and a lightweight price lookup replace bloated per-product option data — one-time $149.

Ayasoftware Colorguide lets you sell products with a huge number of option combinations — every brand × colour × size pairing — without the performance cost of building that out as native Magento custom options. Instead of storing thousands of option/value rows per product, brands, colours, and prices are managed once as shared, lightweight admin data and looked up on demand, so catalog size and page performance do not degrade as the number of combinations grows.

Key Features

  • Built for Scale — Brands, colours, and prices live in their own compact admin tables instead of per-product custom options, so adding thousands of combinations does not bloat product data or slow down saves and reindexing.
  • Fast Swatch Picker — A searchable, swatch-based colour picker grouped by brand, with hex-colour or uploaded swatch-image previews, rendered without the overhead of native custom-option markup.
  • Live Price Lookup — Selecting a colour and size fires a single lightweight request for that combination's price and updates the displayed price immediately, instead of shipping every possible price up front.
  • Admin-Managed Brands, Colours & Prices — Manage brands, individual colours (hex value or uploaded swatch image), and brand/size pricing from Magento admin grids.
  • Custom Colour Code Requests — Shoppers can request a custom colour code outside the standard list, priced as a configurable surcharge over the product's base price.
  • Cart & Order Visibility — The selected colour appears as a line-item option on the cart, order, and reorder screens.

Admin Configuration

Manage brands, colours, and prices from Stores → Colorguide in the Magento admin: add brands, upload or set a hex value for each colour, and configure the price for each brand/size combination.

Stack Requirements

Stack Requirements — ayasoftware/module-colorguide v1.1.0

Core Platform

DependencyVersionNotes
Magento Open Source / Adobe Commerce2.4.x
PHP8.1+Required by Magento framework

PHP Composer Dependencies

PackageVersionPurpose
magento/framework>=103.0Magento 2.4.x framework
magento/module-backend*Admin grids and forms
magento/module-sales*Order-level colour option display
magento/module-quote*Cart pricing
magento/module-checkout*Add-to-cart / update-cart-item integration
magento/module-cms*Admin menu integration
magento/module-catalog*Product page integration

Installation Checklist

Magento Open Source / Adobe Commerce 2.4.x

PHP 8.1+

Composer dependencies installed automatically via composer require ayasoftware/module-colorguide

Note: Designed for simple and configurable products where colour is priced per brand/size. Run bin/magento setup:upgrade after installing to create the brand/colour/price admin tables.

Changelog

1.1.0 August 10, 2026

Security

  • Fixed a price-manipulation issue where cart pricing for colour/size selections could be influenced by a client-submitted value instead of the admin-configured price table; pricing is now always re-derived server-side from Brand/Colour/Price data.
  • Scoped admin permissions for all Colorguide admin screens (brands, colours, prices) to a dedicated ACL resource, so access can be restricted per admin role like any other Magento admin section.
  • Removed an overly broad internal flag that was being set on every add-to-cart action storefront-wide instead of only Colorguide-priced items.

Improvements

  • Confirmed compatibility with PHP 8.1+ and Magento 2.4.x.
  • Fixed an edge case where selecting a colour/size combination with no matching price could return an empty response instead of a clear price.
  • Replaced ad-hoc dependency lookups with standard Magento dependency injection throughout.
  • General code cleanup: removed dead configuration and leftover development placeholders.

Run bin/magento setup:upgrade after updating.

Installation

Install via Composer after configuring your credentials. See your dashboard for your license key.

# 1. Add the repository to your project (one-time)
composer config repositories.ayasoftware composer https://www.ayasoftware.com/repo

# 2. Add your credentials to auth.json (one-time)
composer config --global http-basic.www.ayasoftware.com your@email.com YOUR_LICENSE_KEY

# 3. Require the extension
composer require ayasoftware/module-colorguide

# 4. Enable and upgrade
bin/magento module:enable $(bin/magento module:status --enabled | tail -n +3)
bin/magento setup:upgrade
bin/magento cache:clean
$149
One-time purchase · 12 months of updates & support

What's included

  • Full source code via Composer
  • 12 months of updates & support
  • Use on 1 production + unlimited dev domains
  • Documentation & installation guide
Updates & support renewal
$75/year after the initial support period. Your license key continues to work for the version you purchased — renewals unlock new releases.