Skip to content

Account and Membership Widgets

This page covers the widgets for sign-in and registration, the customer’s profile, addresses, wishlist, membership card and points. For each one it gives the steps to place it and the settings its form offers, in the words the form uses, so you can tell before you start which records and images you need to have ready.

Your job, and the screen for it

The jobScreen or tabRead
Add one of these widgets to a pageDesign Panel › Elements › Account & MembershipConfiguration
Change a widget that is already on the pageClick it on the canvas, Design Panel › Selected NodeIts section under Configuration
Know which settings need an ID, JSON or rich textSelected NodeFields
Make a change reach the shopSAVE NODE, then PublishConfiguring Widgets
Find out why a widget shows nothingTroubleshooting

Overview

The Account & Membership group in the Elements tab holds 17 widgets: entity-widget, login, login-v2, login-v3, member-transactions, membership, membership-points-counter, membership-qr-code, mlm-program-widget, my-payment-methods, my-shipping-address, my-shipping-address-add, my-shipping-address-details, my-wishlist, notification-listing-widget, profile, reseller-widget. Most of these widgets show the signed-in customer’s own records; the sign-in widget is the one that gets them signed in. Placing, saving and publishing work the same for every widget and are explained once in Configuring Widgets in the Website Builder; this page adds what is particular to each widget.

Where it fits

BeforeThese widgetsAfter
You can open the Website Builder and the page exists — User Permission Manager, Layout InstancePlaced on a page and configuredShoppers see them on the storefront after Publish

Screens and menus

Open a page from the Layout Manager tile. In the Design Panel, the Elements tab lists these widgets under Account & Membership, each with its one-line description; the search box matches the description too. Clicking a placed widget on the canvas opens its settings in Selected Node.

Configuration

Before you can use it

  • Everything in Configuring Widgets › Before you can use it: CP Commerce Admin for your login, and the records the widgets point at.
  • Check Platform before you drop a widget: it is added to that platform’s version of the page only.

entity-widget

Customer entity (company) details.

  1. In Elements, open Account & Membership (or search entity-widget) and drag entity-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • Style — Color; Font; Margin; Margin top; Margin bottom; Margin left; Margin right
    • Style › Icon — Color; Icon
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

login

Sign-in and registration form.

  1. In Elements, open Account & Membership (or search login) and drag login onto the page.
  2. In Selected Node, fill in the widget’s form: Sign Up Page and Reset Password Page; Button Background Color, Background Color and Button Font; Registration Type; Privacy Policy Layout; Enable Privacy Agreement with its Privacy Agreement Document, and Enable Terms & Conditions with its document; Require Dob Field and Require Name Field. Under More settings at the bottom of the form:
    • General — Require refferal code; Is enable mini orange login; Can click consent checkbox; Disable privacy terms while sign up
    • Style — Shadow; Font family; Font; Icon; Link font
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

The documents offered for the privacy and terms agreements are user agreement documents (made in CP Commerce Admin), the 100 most recently updated; the screen asks for them without naming this website, so check you pick this shop’s document.

login-v2

Sign-in and registration form (same as login).

  1. In Elements, open Account & Membership (or search login-v2) and drag login-v2 onto the page.
  2. In Selected Node, fill in the widget’s form: Sign Up Page and Reset Password Page; Button Background Color, Background Color and Button Font; Registration Type; Privacy Policy Layout; Enable Privacy Agreement with its Privacy Agreement Document, and Enable Terms & Conditions with its document; Require Dob Field and Require Name Field. Under More settings at the bottom of the form:
    • General — Require refferal code; Is enable mini orange login; Can click consent checkbox; Disable privacy terms while sign up
    • Style — Shadow; Font family; Font; Icon; Link font
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

The same widget as login, with the same form — use either name.

login-v3

Sign-in form for tenant (multi-company) accounts.

  1. In Elements, open Account & Membership (or search login-v3) and drag login-v3 onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Require name; Require DOB; Require refferal code; Registration type (email / phone / emailAndPhone); Privacy policy page (pick a page); Privacy agreement doc GUID; Terms and condition agreement doc GUID; Is enable mini orange login
    • Style — Background; Shadow; Font family; Font; Icon; Button Background; Button font; Link font
    • Page link — Reset password page; Sign up page
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

member-transactions

Membership points transactions.

  1. In Elements, open Account & Membership (or search member-transactions) and drag member-transactions onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Titile; Display points; Display decimal points; Details page (pick a page); Display item name; Theme color; Theme background; Title and icon color; Hide dashboard; Hide title on mobile; Transaction up icon; Transaction down icon
    • Title style — Header color
    • Card style — Card color; Text color
    • Scroll style — Scroller height; Color; Background color; Padding top; Padding bottom; Padding left; Padding right
    • Scroll style › Button config — Background; Shadow; Font family; Font; Icon; Button Background; Button font; Link font
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

membership

Membership card and details.

  1. In Elements, open Account & Membership (or search membership) and drag membership onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Membership colors (a list; each item has GUID, Color); Show bar code; Hide member reward points
    • Style — Secondary color; Icon color; Color; Background; Font
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

membership-points-counter

Membership points balance.

  1. In Elements, open Account & Membership (or search membership-points-counter) and drag membership-points-counter onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Menu list (pick from list); Display menu; Display decimal points; Hide member profile info; Default profile image URL; Show default profile image; Show soon to be expired points
    • Menu style — Color; Background
    • Points style — Color; Point color; Icon color; Background color; Secondary color; Line color; Desktop margin
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

membership-qr-code

Membership QR code.

  1. In Elements, open Account & Membership (or search membership-qr-code) and drag membership-qr-code onto the page.
  2. Selected Node shows This widget has no settings to configure. The widget reads nothing from its settings; give the node a recognisable Name if you like.
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

mlm-program-widget

MLM programme.

  1. In Elements, open Account & Membership (or search mlm-program-widget) and drag mlm-program-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Message
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

my-payment-methods

Saved payment methods.

  1. In Elements, open Account & Membership (or search my-payment-methods) and drag my-payment-methods onto the page.
  2. Selected Node shows This widget has no settings to configure. The widget reads nothing from its settings; give the node a recognisable Name if you like.
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

my-shipping-address

Shipping address list.

  1. In Elements, open Account & Membership (or search my-shipping-address) and drag my-shipping-address onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Add page (pick a page); Edit page (pick a page); Theme color; Theme background; Title and icon color; Hide title on mobile
    • Display — Shipping; Billing
    • Button — Color; Background
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

my-shipping-address-add

Add a shipping address.

  1. In Elements, open Account & Membership (or search my-shipping-address-add) and drag my-shipping-address-add onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Page after saving (pick a page); Theme color; Theme background; Title and icon color
    • Display — Shipping; Billing; Search location; Disable
    • Button — Color; Background
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

my-shipping-address-details

Edit a shipping address.

  1. In Elements, open Account & Membership (or search my-shipping-address-details) and drag my-shipping-address-details onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Page after saving (pick a page); Theme background; Theme color; Title and icon color
    • Display — Shipping; Billing; Search location; Disable
    • Button — Color; Background
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

my-wishlist

Wishlist.

  1. In Elements, open Account & Membership (or search my-wishlist) and drag my-wishlist onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Product details page (pick a page); Line count; Multiple pricing scheme; Checkout page (pick a page); Display marketplace icon; Theme color; Theme background; Title and icon color; Hide product code; Hide title on mobile
    • Style › Product pricing style — Main price size; Main price size mobile; Badge color; Price centered; Color
    • Style › Icon button style — Background; Color
    • Style › Product card style — Box shadow; Border; Product font size; Product code color
    • Feature — Hide add to cart; Hide favourite; Blur image when out of stock; Show max Qty per order; Enable free text quantity; Enable child items Qty selection; Remarks
    • Buy now styling config — Background; Color
    • Add to cart styling config — Background; Color
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

Left empty, Product details page opens the page with the code product-details.

notification-listing-widget

Notifications list.

  1. In Elements, open Account & Membership (or search notification-listing-widget) and drag notification-listing-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Post page (pick a page); Show only iso week ntf listing
    • Listing style — Title color; Description color; Date color
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

profile

Customer profile.

  1. In Elements, open Account & Membership (or search profile) and drag profile onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Display deactivate button; Show referral code; Account deactivation page (pick a page); Deactivate button text; Allow alt login credential; Allow login change; Allow birth date change; Is DOB field mandatory; Is gender field mandatory; Display einvoice profile update button; Google play store URL; Applet app store URL; Visible options (JSON); Default profile image URL; Show default profile image; Theme background; Theme color; Title and icon color
    • Style › Main button style — Color; Background
    • Style › Secondary button style — Color; Background
    • Style — Image border radius; Card border radius; Font; Color; Background
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

reseller-widget

Reseller sign-up and details.

  1. In Elements, open Account & Membership (or search reseller-widget) and drag reseller-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Free delivery text; Middle text
    • Style — Color; Background; Font
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

Fields

The settings are listed with each widget above, in the form’s own words. Colours, lists and JSON behave as described in Configuring Widgets › Step 3.

Settings marked (pick a page) — their labels end in page — open a list of your pages when you click them and fill in the page’s address, /page/ and its code. You can also type any link instead, such as a full https:// address. Left empty, the widget uses its own default page where it has one.

The settings that pick a record, take JSON or hold rich text:

KindWhereWhat to know
Typed IDslogin-v3 › Privacy agreement doc GUID; login-v3 › Terms and condition agreement doc GUID; membership › GUIDNo picker yet: paste the ID of the record. The form accepts any text, so copy it rather than typing it
Typed as JSONprofile › Visible optionsInvalid JSON shows JSON is invalid and is not saved; the last valid value stays
Menu listsmembership-points-counter › Menu listPick it by name from the website’s menu lists, the ones made in Menu Manager. A saved one that is not in the loaded list shows as Not in the list — saved ID …; publish, then reload, before you replace it — a reload loses unpublished changes

Lifecycle and effects

SAVE NODE keeps a change in your browser tab only; Publish sends the page to the shop, and a reload before publishing loses the change. A setting left empty is not saved and the widget uses its own behaviour for it; opening a widget and saving without changes leaves its stored settings as they were. The full sequence is in Configuring Widgets › Lifecycle and effects.

Related applets

  • CP Commerce Admin — decides who may publish, and holds the same pages under Layout Instance.
  • Media Library — where the images these widgets show are uploaded.

Troubleshooting

SymptomCauseFix
The widget is empty on the shopA record it shows is missing or inactiveCheck the records its pickers point at
A change is gone after reloadThe page was not publishedRedo it and Publish before leaving
It shows on desktop but not on phonesIt was added on a desktop platform onlySwitch Platform and add it there too
SAVE NODE does nothingWidget Config (JSON) holds invalid JSONFix or undo the JSON
A picker shows Not in the list — saved ID …The record it saved was deleted, belongs to another website, or is not in the list as loadedPublish what you have first (a reload loses unpublished changes), then reload; if it still shows, check the record before you pick a replacement
A picker shows The list is empty or could not be loadedNothing of that kind exists yet, or loading failedCreate the record first, or reload the page

Related documentation

Last updated on