Wix: How To Install Widgets On Your Website

Table of Contents

• Initial Considerations
• Installation Process
• Troubleshooting

Initial Considerations

• An active Advanced or Premium Plan Subscription is required.
  
  

• You must generate and obtain the required script and button implementation codes from the Widgets’ section upfront. To learn how to properly do that, here.
  
  

• If you’re planning to implement Widgets on a Product Page, the products (hence the Artworks) must be previously listed on your Wix Products list as ‘Physical Products’. We strongly recommend taking a look at this article from Wix Help Center.
  
  

• For non-Product Pages, the Artworks need to be previously uploaded to your ArtPlacer Dashboard Artworks’ section. For more information, please read this article.

Installation Process

Wix requires third party scripts and code like ArtPlacer's to be implemented in a specific manner.
We've put together the following slides to help you throughout the process:

Troubleshooting

• Problem: The Widget buttons are not showing up at all (when installed on a product page).

• Check the following:

  • Go to Wix Studio → Settings → </> Custom Code and confirm the script and button codes are still enabled:
    
    
    
    
    

NOTE: The script should be applied on All pages and the type set to Essential. Button codes should be applied on Product Pages and type set to Essential.

• Problem: The Widget is displaying the wrong Artwork dimensions (when installed on a product page).

• Check the following:
  
  

  • Make sure that the Artworks on your Wix website are listed as ‘physical products’ because the widget will attempt to read the dimensions set at Wix Studio → Catalog → Store products → Products → Product to be displayed → Product options (see below):
    
    
    
    
    

  • The compatible Product option variant formats are the following: “WxH in (or CM)”; “HxW in (or CM)”; “WxH in (or CM) - text”; “HxW in (or CM) - text” (where W= width value and H= height value - see an example below).
    
    

  • The compatible Product option variant names to specify size or dimensions are the following: “Size”; “Sizes”; “Sizing”; “Dimension”; “Dimensions”; “Measurements”; “Measures”. NOTE: If your site is offered in different languages, please reach out to us for further information on this matter.
    
    
    
    Size variants should look similar to this from the visitor's POV  (numeric values upfront):
    
    
    
    

  • Check if the unit of measurement and dimension standard set in the widget code matches with the ones set in your products. Go to the Widget Button settings at Wix Studio → Settings → </> Custom Code → Body - End → Widget Button → Edit settings
    
    

Change the values between captions as needed (“wxh” for “hxw” and/or “in” for “cm”):

• Problem: The Widget is displaying the wrong Artwork dimensions (when installed on a non-product page).

• Check the following:

• Head up to the Artworks’ section within your ArtPlacer account and verify the Artwork dimensions from its edit view.

• Problem: The Widget button is loading in the wrong position.

• Check the following:

  • If you need to check on this, go to the Widget Button settings Wix Studio → Settings → </> Custom Code → Body - End → Widget Button → Edit Custom Code settings and make sure that position: “below-add”, attribute has been defined as shown below:
    

• Problem: The Widget is showing the wrong Artwork image.

• Check the following:

• Go to the Widget Button settings Wix Studio → Settings → </> Custom Code → Body - End → Widget Button → Edit Custom Code settings and verify the number specified between captions where “1” is the first or main image set under the product →  Images and videos gallery:
  
  
  
  

You can change the number between captions if needed.