The Home for Magento 2 Excellence

Quality-tested Magento 2 modules. Explore. Evaluate. Elevate. #magento2

726 Modules
488 Ready
233 Need Help
🏆 Leaderboard
Actively Maintained v1.0.0

QuarryTeam Customer UUID

quarryteam/module-customer-uuid

Adds a unique UUID attribute to Magento 2 customers, automatically generated on install and new customer creation. Exposes the UUID via GraphQL and displays it in the admin customer grid and edit form.

8
Downloads
Below average
0
GitHub Stars
5d ago
Last Release
0
Open Issues
Build Passing
Ready to install

Build Tests

Composer Install
DI Compile
Templates

Code Quality

CS Coding Standard
51 warnings
PHPStan Failed

Tested on Magento 2.4.8-p4

Recent Test History

Each release is tested against the latest Magento version at that time.

v1.0.0 on Magento 2.4.8-p4
Mar 21, 2026
v1.0.0 on Magento 2.4.8-p3
Mar 20, 2026

Share This Module's Status

QuarryTeam Customer UUID Magento compatibility status badge

README

Loaded from GitHub

QuarryTeam_CustomerUuid

Adds a uuid attribute to customers:

  • Stored in dedicated customer UUID EAV backend table with DB-level unique UUID constraint.
  • Automatically generated for existing customers on install and for new customers on save.
  • Exposed via GraphQL on the Customer type as uuid for authenticated customers.
  • Displayed on the Admin customer grid.
  • Visible in Admin customer edit form (customer account section) and treated as immutable once set.
  • UUID generation uses ramsey/uuid (v4).

Installation (composer)

To install via composer:

composer require quarryteam/module-customer-uuid
bin/magento module:enable QuarryTeam_CustomerUuid
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento indexer:reindex customer_grid
bin/magento cache:clean

GraphQL usage

API Access

  1. Create a customer token
curl -X POST "http://<magento-base-url>/graphql/"" \\

-H "Content-Type: application/json" \\

-d '{"query":"mutation generateCustomerToken(\n  $email: String!,\n  $password: String!\n) {\n  generateCustomerToken(\n    email: $email,\n    password: $password\n  ) {\n    token\n  }\n}","variables":{"email":"<customer email>","password":"<customer password>"}}'

Response: a token string (JWT-like value depending on setup).

  1. Query UUID via GraphQL Use the token in the Authorization header:
curl -X POST "https://<magento-base-url>/graphql" \\

-H "Content-Type: application/json" \\

-H "Authorization: Bearer <customer-token>" \\

-d '{"query":"{ customer { email uuid } }"}'

Example GraphQL query:

{
  customer {
    email
    uuid
  }
}

Tests

Unit tests (module-local)

Run PHPUnit for the module unit tests (requires Magento unit test framework setup):

vendor/bin/phpunit -c dev/tests/unit/phpunit.xml.dist vendor/quarryteam/module-customer-uuid/Test/Unit

This content is fetched directly from the module's GitHub repository. We are not the authors of this content and take no responsibility for its accuracy, completeness, or any consequences arising from its use.