---
title: "MemberLevel"
description: "Customer membership level information."
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/storefront-api/member-system/objects/member-level'
  md: 'https://developer.shopline.com/docs/storefront-api/member-system/objects/member-level.md'
---
# MemberLevel

Customer membership level information. 

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Fields

* `levelCode`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The code of the customer's current membership level.  
  
  Maximum length: 25

* `levelName`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The name of the customer's current membership level.
  
  Maximum length: 25

* `membershipType`

  [MembershipType](https://developer.shopline.com/docs/storefront-api/member-system/enums/membership-type.md)

  The membership type of the customer's current level. 

* `levelOrder`

  [Int](https://developer.shopline.com/docs/storefront-api/common/scalars/int.md)

  Level sequence number. The larger the `level_order`, the higher the level and the later the sequence.

* `levelIcon`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  The `icon` of the level.

* `upgradeStandard`

  [UpgradeStandard](https://developer.shopline.com/docs/storefront-api/member-system/enums/upgrade-standard.md)

  The standard type of system-triggered upgrade when customers meet the upgrade criteria by purchasing regular products (including gift cards).
  Threshold type for the level when `membershipType` = `BASIC` or `DUAL`. 

* `levelThreshold`

  [UnsignedInt64](https://developer.shopline.com/docs/storefront-api/common/scalars/unsigned-int-64.md)

  The spending threshold amount required for a customer to upgrade their membership level via purchases. This field is only valid when `membershipType` is `BASIC` or `DUAL`. The value of this field is the amount in the store currency, multiplied by 100.<br/>For example, if the threshold amount required for the upgrade is $10.00, the field value is `1000`.

* `lockinStandard`

  [LockinStandard](https://developer.shopline.com/docs/storefront-api/member-system/enums/lockin-standard.md)

  The retention criterion type applicable to consumers who upgrade their membership via spending, when the merchant configures membership retention rules. 
  Only valid when `membershipType` = `BASIC` or `DUAL`. 

* `lockinRule`

  [UnsignedInt64](https://developer.shopline.com/docs/storefront-api/common/scalars/unsigned-int-64.md)

  The specific amount the customer needs to spend to meet retention conditions after the merchant configures retention rules. Valid only when `membershipType` = `BASIC` or `DUAL`.

* `paidPrice`

  [[LevelSkuInfo]](https://developer.shopline.com/docs/storefront-api/member-system/objects/level-sku-info.md)

  The paid price required for upgrading when the upgrade method is consumption-based. Valid when `membership_type` = `PAID` or `DUAL`.

* `paidExpiryDateType`

  [PaidExpiryDateType](https://developer.shopline.com/docs/storefront-api/member-system/enums/paid-expiry-date-type.md)

  The time type of the paid membership validity period. 

* `paidExpiryDateValue`

  [Int](https://developer.shopline.com/docs/storefront-api/common/scalars/int.md)

  Time value of the paid membership validity.

* `upgradePaidPriceSpu`

  [UpgradePaidPriceSpu](https://developer.shopline.com/docs/storefront-api/member-system/objects/upgrade-paid-price-spu.md)

  The price range required for an upgradeable membership level is only valid if the paid membership item associated with that level is a multi-item product.
  Customers at the membership tier corresponding to `upgrade_level_code` upgrade by paying the `upgrade_paid_price`.
  Only valid when `membership_type` = `BASIC` or `DUAL`. and `paid_upgrade_standard` = `CUSTOMISED`.

* `upgradePaidPriceSku`

  [[UpgradePaidPriceSku]](https://developer.shopline.com/docs/storefront-api/member-system/objects/upgrade-paid-price-sku.md)

  The price required for an upgradeable membership level is only valid if the paid membership item for that level has only a single product style.
  Customers at the membership tier corresponding to `upgrade_level_code` upgrade by paying the `upgrade_paid_price`.
  Only valid when `membership_type` = `BASIC` or `DUAL`. and `paid_upgrade_standard` = `CUSTOMISED`.

* `paidUpgradeStandard`

  [PaidUpgradeStandard](https://developer.shopline.com/docs/storefront-api/member-system/enums/paid-upgrade-standard.md)

  The criterion type followed by the system for membership level upgrade when a customer purchases a membership via payment.
  Only valid when `membershipType` = `BASIC` or `DUAL`. 

## Field from

* [Query](https://developer.shopline.com/docs/storefront-api/member-system/queries/store-membership-type.md).storeMembershipType