Skip to main content
Version: 1.0.0

Last Update: 25/03/2026

ARPDMeter Component

This page describes how to add, configure, and customise the ARPDMeter block in the Shopify Theme Editor across any compatible section or template of your storefront.


Adding the Block in Theme Editor

  1. Open Shopify Admin > Online Store > Themes > Customize.
  2. Navigate to the template or section where you want to place ARPDMeter.
  3. In the sidebar, click + Add block in the target section area.
  4. Under Apps, select ARShades PD Meter.

ARShades PD Meter in the block selector

You will also see the other ARShades components in the list:

  • ARShades PD Meter — Pupillary distance measurement.
  • ARShades Product 3D/AR — 3D product viewer.
  • ARShades Product VTO — Augmented reality virtual try-on.
  • ARShades VTO/3D Button — Combined VTO and 3D button.
  1. Position the block in a high-visibility area (near price, variants, or the buy button).
  2. Click Save.

Configuration Properties

Click on the ARShades PD Meter block to open the settings panel on the right:

ARShades PD Meter settings panel

PD Meter Language Configuration

PropertyDescriptionDefault
PD Meter LanguageLanguage used by the PD Meter interface and audio guidance. If the store's language matches one of the supported languages, it is used automatically. Otherwise, English is applied as fallback. You can override this by selecting a specific language in this setting.Store language (if supported), otherwise English

Supported languages:

CodeLanguage
enEnglish
itItaliano
deDeutsch
esEspañol
frFrançais

Button Settings

PropertyDescriptionDefault
Button TextText displayed on the CTA button.Measure PD
Show IconShow or hide the icon next to the button text.On
Custom IconUpload a custom icon image. Leave empty to use the default crosshair icon.
Icon SizeIcon size in pixels (range slider).24 px
Button ColorButton background colour.#000000
Button Hover ColorButton colour on mouse hover.#333333
Button Text ColorText colour on the button.#FFFFFF
Button RadiusBorder radius of the button in pixels.8 px
Font SizeFont size for the button text.16 px
Button WidthButton width option (Full Width, Auto, 50%).Full Width

How It Works for End Users

The ARPDMeter flow is a guided step-by-step experience:

  1. The customer clicks the Measure PD button (or the custom text you have configured).
  2. The measurement interface opens, guiding the user with visual and audio instructions in the configured language.
  3. At the end, the customer receives the measurement result in a readable format.

The entire experience runs in the browser — no additional app installation is required.


License Dependency

If the ARPDMeter license is not active, the block will display a warning message instead of the functional component:

ARPDMeter block without active license

To verify or activate the license, see ARPDMeter License.