magematch/module-customer-uuid

Assigns a unique UUID v4 attribute to every Magento 2 customer, exposes it via GraphQL, and displays it read-only in the admin customer grid and form.

dev-main 2026-05-15 13:26 UTC

Requires

• php: >=8.1
• magento/framework: *
• magento/module-customer: *
• magento/module-customer-graph-ql: *
• magento/module-eav: *
• magento/module-graph-ql: *
• magento/module-ui: *

Requires (Dev)

• phpunit/phpunit: ^9.6 || ^10.0

MIT

README

This module adds a uuid field to every customer and shows it in admin and GraphQL.

Compatibility

	Version
PHP	8.1 – 8.5
Magento / Adobe Commerce	2.4.6 – 2.4.9

Install

Composer (VCS / GitHub)

Add the repo to your composer.json:

"repositories": [
    {
        "type": "vcs",
    "url": "https://github.com/arjundhi/module-customer-uuid.git"
    }
]

Install and run setup:

composer require magematch/module-customer-uuid
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Reindex the customer grid so the UUID column appears:

bin/magento indexer:reindex customer_grid

Manual

cp -r . app/code/Magematch/CustomerUuid
bin/magento module:enable Magematch_CustomerUuid
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
bin/magento indexer:reindex customer_grid

What it does

• Adds a uuid attribute to customers.
• Fills UUID for existing customers during setup:upgrade.
• Generates UUID for new customers automatically.
• Shows UUID in Customers → All Customers grid.
• Makes UUID read-only in admin edit form.
• Exposes UUID in GraphQL for logged-in customers.

GraphQL example

query {
  customer {
    uuid
  }
}

Tests

vendor/bin/phpunit app/code/Magematch/CustomerUuid/Test/Unit

Uninstall

bin/magento module:uninstall Magematch_CustomerUuid --remove-data

Backward compatibility

• Supports Magento 2.4.6 – 2.4.9 with PHP 8.1+.
• Uses core Magento APIs only, no new platform dependencies.