Each easyPoints tier is assigned a unique identifier called a “uid”.
This identifier is mainly required when converting tiers into metafields or when using them for segmentation. Each tier is assigned one uid that does not change, regardless of any modifications to the tier settings.
Please refer to the instructions below to check the uid for each tier.
How to Check the uids
Access the metafield information of a test account
Create a test account in Shopify and go to the customer detail page from the customer management section.
Make sure that the test account belongs to the default tier.
Add /metafields.json to the end of the customer detail page URL and press Enter. You will then be able to view all metafield information for the customer in JSON format.
(If your browser supports a JSON formatter or you use an online formatter, you can display the information in a more readable format.)
Extract the uid from the easyPoints metafield information
In the JSON file, locate the metafield with:
"namespace": "loyalty", "key": "easy_points_attributes"
From the value of this metafield, you can extract the uid for each tier.
The uids for each tier can be found in: loyalty.easy_points_attributes.value.tier_maintenance_data.advancement_data.tiers
loyalty.easy_points_attributes.value
└── tier_maintenance_data
└── advancement_data
└── tiers ← here's where the uids are found
e.g.
"value": "{\"tier\":\"Silver\",\"balance\":133030,\"point_value\":1,\"tier_uid\":\"f80c71c0-5363-4c78-903f-a6ee8cae6081\",\"expiration_date\":\"2026-07-24T23:59:59+09:00\",\"tier_maintenance_data\":{\"advancement_data\":{\"currency\":\"JPY\",\"tiers\":
[{\"name\":\"Silver\",\"currency\":\"JPY\",\"uid\":\"f80c71c0-5363-4c78-903f-a6ee8cae6081\",\"amount\":\"0\",\"ratio\":0.01,\"spent_requirement\":{\"currency\":\"JPY\",\"amount\":\"0\",\"raw_amount\":0},\"raw_amount\":0},
{\"name\":\"Gold\",\"currency\":\"JPY\",\"uid\":\"7b3e4ebe-fac1-4b22-97b5-c8a013c0a12b\",\"amount\":\"0\",\"ratio\":0.02,\"spent_requirement\":{\"currency\":\"JPY\",\"amount\":\"100000\",\"raw_amount\":100000},\"raw_amount\":0},
{\"name\":\"Platinum\",\"currency\":\"JPY\",\"uid\":\"7f1f6c5d-362b-4e1b-a985-ebe6fc132ffb\",\"amount\":\"28768\",\"ratio\":0.03,\"spent_requirement\":{\"currency\":\"JPY\",\"amount\":\"200000\",\"raw_amount\":200000},\"raw_amount\":28768},
{\"name\":\"Diamond\",\"currency\":\"JPY\",\"uid\":\"4b196120-0d3b-48ae-90f6-bb87cf9a8d42\",\"amount\":\"128768\",\"ratio\":0.04,\"spent_requirement\":{\"currency\":\"JPY\",\"amount\":\"300000\",\"raw_amount\":300000},\"raw_amount\":128768}]
Tiers and uids are as follows
Silver: f80c71c0-5363-4c78-903f-a6ee8cae6081
Gold: 7b3e4ebe-fac1-4b22-97b5-c8a013c0a12b
Platinum: 7f1f6c5d-362b-4e1b-a985-ebe6fc132ffb
Diamond: 4b196120-0d3b-48ae-90f6-bb87cf9a8d42