{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"🏷️ Metafields & Tags","description":"Build powerful loyalty and rewards experiences for your Shopify store with our comprehensive REST APIs.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"️-metafields--tags","__idx":0},"children":["🏷️ Metafields & Tags"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"hero-section","style":{"margin":"24px 0"}},"children":[{"$$mdtype":"Tag","name":"h3","attributes":{"style":{"color":"white","marginBottom":"12px"}},"children":["Shopify Metafields & Tags Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Appstle Loyalty uses Shopify metafields and tags to store loyalty program data, power storefront widgets, sync product reviews, and enable automation workflows. This reference covers every metafield and tag — what it contains, when it's set, and how to use it in your integration."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-metafields-overview","__idx":1},"children":["📦 Metafields Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Appstle Loyalty uses ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["three namespaces"]}," across multiple resource types:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Namespace"},"children":["Namespace"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resources"},"children":["Resources"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Visibility"},"children":["Visibility"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop, Customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public (readable by any app/theme)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Loyalty program configuration, customer loyalty profiles"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$app:appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Private"]}," (only readable by this app)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer reward discount codes for checkout"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_review"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product, Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product reviews, ratings, and carousel data"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Private namespace note:"]}," The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$app:appstle_loyalty"]}," namespace uses Shopify's app-owned metafield protection. Metafields in this namespace can only be read and written by the Appstle Loyalty app itself — not by themes, Liquid templates, or other apps."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-shop-metafields--loyalty-program--appstle_loyalty-","__idx":2},"children":["🏪 Shop Metafields — Loyalty Program (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These metafields store the complete loyalty program configuration and are used by the storefront widget to render the loyalty experience. They are written by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubscribeItScriptUtils.writeShopMetafield()"]}," whenever a merchant saves settings."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["When updated:"]}," On every settings save in the Appstle admin, and when point rules or VIP tiers are modified. Updates are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["synchronous"]}," (immediate)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"core-configuration","__idx":3},"children":["Core Configuration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["app_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["App base URL for widget communication"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["proxy_path_prefix"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom proxy path prefix (default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apps/loyalty"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["public_domain"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Store's public domain name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shop_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Store name from Shopify"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO currency code (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EUR"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["store_front_access_token"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shopify Storefront API access token"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"widget-configuration","__idx":4},"children":["Widget Configuration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bundle_js_path"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CDN URL for widget JS bundle (with version params)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bundle_css_path"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CDN URL for widget CSS bundle (with version params)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget_setting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full widget configuration object (colors, layout, positioning, etc.)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shop_labels"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Widget label translations (i18n support)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"points-configuration","__idx":5},"children":["Points Configuration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pointRoundType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Point rounding strategy: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO_ROUND"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROUND_DOWN"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROUND_UP"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["point_earn_rules"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of all active point earn rules"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["point_redeem_rules"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of all active point redeem rules"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-point_earn_rules","__idx":6},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["point_earn_rules"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"id\": 123,\n    \"type\": \"PURCHASE\",\n    \"pointsPerDollar\": 5,\n    \"minimumOrderAmount\": 0,\n    \"enabled\": true\n  },\n  {\n    \"id\": 124,\n    \"type\": \"SIGNUP\",\n    \"fixedPoints\": 100,\n    \"enabled\": true\n  },\n  {\n    \"id\": 125,\n    \"type\": \"BIRTHDAY\",\n    \"fixedPoints\": 200,\n    \"enabled\": true\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-point_redeem_rules","__idx":7},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["point_redeem_rules"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"id\": 456,\n    \"type\": \"FIXED_AMOUNT\",\n    \"pointsCost\": 500,\n    \"discountValue\": 5.00,\n    \"discountType\": \"FIXED_AMOUNT\",\n    \"enabled\": true\n  },\n  {\n    \"id\": 457,\n    \"type\": \"PERCENTAGE\",\n    \"pointsCost\": 1000,\n    \"discountValue\": 10,\n    \"discountType\": \"PERCENTAGE\",\n    \"maxDiscountAmount\": 50.00,\n    \"enabled\": true\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"feature-flags","__idx":8},"children":["Feature Flags"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enable_inactive_customer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Allow tracking inactive customers in the program"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["has_dedicated_page_access"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access to dedicated loyalty page feature"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allow_customer_opt_in"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Allow customer self-opt-in to the loyalty program"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enable_discount_to_apply_automatically"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Auto-apply reward discounts at checkout"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["show_store_credit_rewards"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Show store credit rewards in the widget"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["birthdate_format"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Expected birthdate format (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MM/DD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DD/MM"]},", etc.)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"referral-configuration","__idx":9},"children":["Referral Configuration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referral_enabled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Referral program enabled flag"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referral_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Referral config (discount type, tags, amounts)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-referral_loyalty","__idx":10},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referral_loyalty"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"referrerDiscountType\": \"PERCENTAGE\",\n  \"referrerDiscountValue\": 10,\n  \"referredDiscountType\": \"FIXED_AMOUNT\",\n  \"referredDiscountValue\": 5.00,\n  \"referrerPoints\": 500,\n  \"referredPoints\": 200\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"vip-tier-configuration","__idx":11},"children":["VIP Tier Configuration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip_tier_enabled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["VIP tier program enabled flag"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip_tiers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of VIP tier definitions"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip_rewards"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["VIP tier-specific point redeem rules"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip_point_rewards"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["VIP tier-specific point earn rules"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip_tier_setting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["VIP tier configuration object"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-vip_tiers","__idx":12},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip_tiers"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"id\": 1,\n    \"name\": \"Silver\",\n    \"threshold\": 0,\n    \"icon\": \"🥈\",\n    \"additionalTags\": \"silver-member\"\n  },\n  {\n    \"id\": 2,\n    \"name\": \"Gold\",\n    \"threshold\": 1000,\n    \"icon\": \"🥇\",\n    \"additionalTags\": \"gold-member, premium-support\"\n  },\n  {\n    \"id\": 3,\n    \"name\": \"Platinum\",\n    \"threshold\": 5000,\n    \"icon\": \"💎\",\n    \"additionalTags\": \"platinum-member, priority-shipping, premium-support\"\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"points-expiration","__idx":13},"children":["Points Expiration"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["points_expiration_setting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Point expiration config (interval and type)"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"enabled\": true,\n  \"interval\": 12,\n  \"intervalType\": \"MONTH\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"metafield-deletion","__idx":14},"children":["Metafield Deletion"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Shop metafields can be removed via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MiscellaneousResource.removeShopMetafield()"]}," — this is used when resetting or disabling features."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-customer-metafields--loyalty-profile--appstle_loyalty-","__idx":15},"children":["👤 Customer Metafields — Loyalty Profile (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]},")"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"appstle_loyalty--customer_loyalty","__idx":16},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_loyalty"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resource"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Visibility"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public (readable by themes and other apps)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Set by"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubscribeItScriptUtils.writeCustomerMetafield()"]}," (loyalty-l / Lambda)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Updated when"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["After every loyalty event: point earn, point redeem, VIP tier change, referral, social engagement, etc."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Update mechanism"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Processed by AWS Lambda (loyalty-l), updates are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["near real-time"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," This metafield is set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["only"]}," by the Lambda processor (loyalty-l), not by the main loyalty app. It's updated after every loyalty event."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"availablePoints\": 1250,\n  \"pendingPoints\": 100,\n  \"redeemedPoints\": 500,\n  \"creditedPoints\": 1850,\n  \"vipTier\": {\n    \"id\": 2,\n    \"name\": \"Gold\"\n  },\n  \"achievableTierId\": 3,\n  \"activeRewards\": [\n    {\n      \"discountCode\": \"REWARD-XYZ789\",\n      \"discountType\": \"PERCENTAGE\",\n      \"discountValue\": 10\n    }\n  ],\n  \"socialMediaEngagement\": {\n    \"facebook\": true,\n    \"twitter\": false,\n    \"instagram\": true,\n    \"youtube\": false,\n    \"tiktok\": false,\n    \"pinterest\": false,\n    \"newsletter\": true,\n    \"sms\": false,\n    \"accountCreation\": true,\n    \"sharing\": false\n  },\n  \"referralInfo\": {\n    \"referralLink\": \"https://store.myshopify.com/?ref=abc123\",\n    \"completedReferrals\": 3\n  },\n  \"customerStatus\": \"ACTIVE\",\n  \"dateOfBirth\": \"1990-05-15\",\n  \"storeCreditBalance\": 25.00,\n  \"lastActivityDate\": \"2025-03-20T14:30:00Z\",\n  \"spentAmount\": 450.75\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-customer-metafields--reward-codes--appappstle_loyalty-","__idx":17},"children":["🔒 Customer Metafields — Reward Codes (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$app:appstle_loyalty"]},")"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"appappstle_loyalty--customer_rewards","__idx":18},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$app:appstle_loyalty"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_rewards"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resource"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Visibility"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Private"]}," — only readable by the Appstle Loyalty app"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Set by"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommonUtils.syncCustomerRewardMetafield()"]}," (loyalty) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubscribeItScriptUtils.syncCustomerRewardMetafield()"]}," (loyalty-l)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Updated when"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer redeems points for a reward, reward expires, or reward is used"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Purpose"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stores active discount codes for Shopify checkout discount functions"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"rewards\": [\n    { \"discountCode\": \"REWARD-ABC123\" },\n    { \"discountCode\": \"REWARD-DEF456\" }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Why private?"]}," This metafield uses the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$app:"]}," prefix to prevent external access. It contains discount codes that should only be validated by the Shopify discount function, not exposed to themes or third-party apps."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-product-metafields--reviews--appstle_review-","__idx":19},"children":["⭐ Product Metafields — Reviews (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_review"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Product review metafields are set on individual ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Product"]}," resources and on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shop"]}," resource (for carousel displays)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Set by:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubscribeItScriptUtils.createOrUpdateProductMetafield()"]}," in both loyalty and loyalty-l repos."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Updated when:"]}," A review is approved, updated, or deleted. Updates are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["synchronous"]}," in the main app and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["near real-time"]}," from Lambda."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"per-product-metafields","__idx":20},"children":["Per-Product Metafields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_reviews"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of approved reviews for the product detail page (paginated, max 5 per page)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total_reviews"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["integer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total review count for the product"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rating"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rating"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Overall product rating (Shopify native rating type: value, scale_min=1, scale_max=5)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_rating_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Breakdown by star rating (map of rating → count)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-product_reviews","__idx":21},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_reviews"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"id\": 789,\n    \"author\": \"John D.\",\n    \"rating\": 5,\n    \"title\": \"Amazing product!\",\n    \"body\": \"This is the best coffee I've ever had.\",\n    \"createdAt\": \"2025-03-15T10:00:00Z\",\n    \"verified\": true\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-rating-shopify-native-rating-type","__idx":22},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rating"]}," (Shopify native rating type)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"value\": \"4.5\",\n  \"scale_min\": \"1\",\n  \"scale_max\": \"5\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-product_rating_details","__idx":23},"children":["Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_rating_details"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"5\": 42,\n  \"4\": 18,\n  \"3\": 7,\n  \"2\": 2,\n  \"1\": 1\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"shop-level-carousel-metafields--appstle_review-on-shop","__idx":24},"children":["Shop-Level Carousel Metafields (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_review"]}," on Shop)"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carousel_product_reviews"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recent/featured reviews for the homepage carousel widget (max 15 reviews)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carousel_total_reviews"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["integer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total count of reviews in the carousel"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carousel_rating"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rating"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Overall rating for the carousel display (Shopify native rating type)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"️-tags-overview","__idx":25},"children":["🏷️ Tags Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Appstle Loyalty applies tags to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer"]}," resources only. No tags are applied to orders or products."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All tags are applied using the Shopify GraphQL Admin API (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TagsAddMutation"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TagsRemoveMutation"]},")."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-customer-tags","__idx":26},"children":["👤 Customer Tags"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"vip-tier-name-tags","__idx":27},"children":["VIP Tier Name Tags"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resource"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Format"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dynamic — the VIP tier's name (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Silver"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Gold"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Platinum"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Applied when"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer achieves or is promoted to a VIP tier (automatic calculation or manual assignment)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Removed when"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer's tier changes (upgrade, downgrade, or removal)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mutual exclusivity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only the current tier's name tag is active — previous tier name tags are removed"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["When tier tags are applied:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Automatic VIP tier calculation (based on spend, points, or order count thresholds)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Manual tier assignment by merchant"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Referral flow VIP assignment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Shopify Flow trigger VIP assignment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Bulk operations VIP assignment"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-vip-tier-tags-merchant-configured","__idx":28},"children":["Additional VIP Tier Tags (Merchant-Configured)"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resource"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Format"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Comma-separated tags configured per tier in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additionalTags"]}," field"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Applied when"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Along with the tier name tag when a customer achieves a VIP tier"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Removed when"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer leaves the tier (upgrade, downgrade, or removal)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configuration"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set per VIP tier in the Appstle admin under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["VIP Tiers"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example","__idx":29},"children":["Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A \"Gold\" tier configured with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additionalTags = \"premium-member, vip-support\""]}," will apply three tags when a customer reaches Gold:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Gold"]}," (the tier name)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["premium-member"]}," (additional tag)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip-support"]}," (additional tag)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the customer upgrades to Platinum, all three Gold tags are removed and replaced with Platinum's tags."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"referral-tags","__idx":30},"children":["Referral Tags"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resource"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Format"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Two tags per referral relationship"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Applied when"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A referral offer is accepted by both parties"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Removed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Never (referral tags are permanent)"]}]}]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tag Pattern"},"children":["Tag Pattern"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Applied To"},"children":["Applied To"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referral:{referralCustomerId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["referrer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies the referred customer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referred:{originalCustomerId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["referred customer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies who referred them"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-1","__idx":31},"children":["Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customer A (ID: 1111) refers Customer B (ID: 2222):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Customer A gets tag: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referral:2222"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Customer B gets tag: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referred:1111"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"product-review-tag","__idx":32},"children":["Product Review Tag"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resource"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Format"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Wrote Appstle Web Review"]}," (static string)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Applied when"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A new Shopify customer is created via product review submission (only if the customer didn't previously exist in Shopify)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Removed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Never (permanent tag)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-summary-tables","__idx":33},"children":["📊 Summary Tables"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"all-metafields-at-a-glance","__idx":34},"children":["All Metafields at a Glance"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"#"},"children":["#"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resource"},"children":["Resource"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Namespace"},"children":["Namespace"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Key"},"children":["Key"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Visibility"},"children":["Visibility"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["app_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["proxy_path_prefix"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["public_domain"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shop_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["6"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pointRoundType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["7"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["point_earn_rules"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["8"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["point_redeem_rules"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["9"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bundle_js_path"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["url"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["10"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bundle_css_path"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["url"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["11"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["widget_setting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["12"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shop_labels"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["13"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enable_inactive_customer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["14"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["has_dedicated_page_access"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["15"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allow_customer_opt_in"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["16"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enable_discount_to_apply_automatically"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["17"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["store_front_access_token"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["18"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["birthdate_format"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["19"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["show_store_credit_rewards"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["20"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referral_enabled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["21"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referral_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["22"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip_tier_enabled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["23"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip_tiers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["24"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip_rewards"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["25"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip_point_rewards"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["26"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vip_tier_setting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["27"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["points_expiration_setting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["28"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["29"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$app:appstle_loyalty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_rewards"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Private"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["30"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_review"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_reviews"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["31"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_review"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total_reviews"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["32"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_review"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rating"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["rating"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["33"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_review"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_rating_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["34"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_review"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carousel_product_reviews"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["json"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["35"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_review"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carousel_total_reviews"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["36"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_review"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carousel_rating"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["rating"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Public"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"all-tags-at-a-glance","__idx":35},"children":["All Tags at a Glance"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"#"},"children":["#"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resource"},"children":["Resource"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tag Pattern"},"children":["Tag Pattern"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"When Applied"},"children":["When Applied"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Permanent?"},"children":["Permanent?"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{VIP tier name}"]}," (dynamic)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["VIP tier assignment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No (swapped on tier change)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{additionalTags}"]}," (merchant-configured per tier)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["VIP tier assignment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No (swapped on tier change)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referral:{customerId}"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referred:{customerId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Referral acceptance"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Wrote Appstle Web Review"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New customer created via review"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"graphql-mutations-used","__idx":36},"children":["GraphQL Mutations Used"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Mutation"},"children":["Mutation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MetafieldsSetMutation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create or update metafields on any resource"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MetafieldsDeleteMutation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete metafields"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TagsAddMutation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add tags to customers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TagsRemoveMutation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove tags from customers"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"-faq","__idx":37},"children":["❓ FAQ"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Can I read loyalty metafields from my Liquid theme?"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes — metafields in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_loyalty"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appstle_review"]}," namespaces are public. Access them in Liquid via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{ customer.metafields.appstle_loyalty.customer_loyalty }}"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{ product.metafields.appstle_review.rating }}"]},". However, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_rewards"]}," in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$app:appstle_loyalty"]}," namespace is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["private"]}," and not accessible in Liquid."]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How quickly are customer loyalty metafields updated?"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customer loyalty metafields are updated by the Lambda processor (loyalty-l) after every loyalty event. Updates are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["near real-time"]}," — typically within a few seconds."]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What happens to VIP tier tags when a customer is upgraded?"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a customer's VIP tier changes, the old tier's name tag and all its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additionalTags"]}," are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["removed"]},", and the new tier's name tag and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additionalTags"]}," are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["added"]},". Only one tier's tags are active at a time."]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Can other apps read the customer_rewards discount codes?"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_rewards"]}," metafield uses the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$app:appstle_loyalty"]}," namespace, which is a private app-owned namespace. Only the Appstle Loyalty app can read and write it. This protects discount codes from being exposed to unauthorized apps."]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How do product review ratings work with Shopify's native rating type?"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rating"]}," metafield uses Shopify's native ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rating"]}," type (not JSON), which integrates directly with Shopify's built-in rating display, Google rich results, and other SEO features. The value is on a scale of 1 to 5."]}]}]},"headings":[{"value":"🏷️ Metafields & Tags","id":"️-metafields--tags","depth":1},{"value":"📦 Metafields Overview","id":"-metafields-overview","depth":2},{"value":"🏪 Shop Metafields — Loyalty Program ( appstle_loyalty )","id":"-shop-metafields--loyalty-program--appstle_loyalty-","depth":2},{"value":"Core Configuration","id":"core-configuration","depth":3},{"value":"Widget Configuration","id":"widget-configuration","depth":3},{"value":"Points Configuration","id":"points-configuration","depth":3},{"value":"Example: point_earn_rules","id":"example-point_earn_rules","depth":4},{"value":"Example: point_redeem_rules","id":"example-point_redeem_rules","depth":4},{"value":"Feature Flags","id":"feature-flags","depth":3},{"value":"Referral Configuration","id":"referral-configuration","depth":3},{"value":"Example: referral_loyalty","id":"example-referral_loyalty","depth":4},{"value":"VIP Tier Configuration","id":"vip-tier-configuration","depth":3},{"value":"Example: vip_tiers","id":"example-vip_tiers","depth":4},{"value":"Points Expiration","id":"points-expiration","depth":3},{"value":"Metafield Deletion","id":"metafield-deletion","depth":3},{"value":"👤 Customer Metafields — Loyalty Profile ( appstle_loyalty )","id":"-customer-metafields--loyalty-profile--appstle_loyalty-","depth":2},{"value":"appstle_loyalty / customer_loyalty","id":"appstle_loyalty--customer_loyalty","depth":4},{"value":"🔒 Customer Metafields — Reward Codes ( $app:appstle_loyalty )","id":"-customer-metafields--reward-codes--appappstle_loyalty-","depth":2},{"value":"$app:appstle_loyalty / customer_rewards","id":"appappstle_loyalty--customer_rewards","depth":4},{"value":"⭐ Product Metafields — Reviews ( appstle_review )","id":"-product-metafields--reviews--appstle_review-","depth":2},{"value":"Per-Product Metafields","id":"per-product-metafields","depth":3},{"value":"Example: product_reviews","id":"example-product_reviews","depth":4},{"value":"Example: rating (Shopify native rating type)","id":"example-rating-shopify-native-rating-type","depth":4},{"value":"Example: product_rating_details","id":"example-product_rating_details","depth":4},{"value":"Shop-Level Carousel Metafields ( appstle_review on Shop)","id":"shop-level-carousel-metafields--appstle_review-on-shop","depth":3},{"value":"🏷️ Tags Overview","id":"️-tags-overview","depth":2},{"value":"👤 Customer Tags","id":"-customer-tags","depth":2},{"value":"VIP Tier Name Tags","id":"vip-tier-name-tags","depth":3},{"value":"Additional VIP Tier Tags (Merchant-Configured)","id":"additional-vip-tier-tags-merchant-configured","depth":3},{"value":"Example","id":"example","depth":4},{"value":"Referral Tags","id":"referral-tags","depth":3},{"value":"Example","id":"example-1","depth":4},{"value":"Product Review Tag","id":"product-review-tag","depth":3},{"value":"📊 Summary Tables","id":"-summary-tables","depth":2},{"value":"All Metafields at a Glance","id":"all-metafields-at-a-glance","depth":3},{"value":"All Tags at a Glance","id":"all-tags-at-a-glance","depth":3},{"value":"GraphQL Mutations Used","id":"graphql-mutations-used","depth":3},{"value":"❓ FAQ","id":"-faq","depth":2}],"frontmatter":{"seo":{"title":"🏷️ Metafields & Tags"}},"lastModified":"2026-03-22T06:20:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/metafields-and-tags","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}