Parameters are options that define how your shop looks on your website. You can for example, determine how your products are ordered and how an image is shown.
The parameters are part of the embed code of your Online Shop and look like this:
showCategorySelector: true imageRatio: 'square' cropImages: true productsPerPage: 15 productsPerRow: 5
showProductPreview: true, sortProducts: 'name-ascending' userCanSortProducts: true
buttonClassname: 'btn-myclass',
buyButtonText: 'Buy',
embedType: 'html'
If you use Website Builder to publish your shop, you can easily change the settings there. However, if you want to embed your shop manually with the HTML code, you should use this.
Note: The parameters sortProducts and showProductPreview are no longer supported in the embedded version of the shop. Because of this, they are excluded from the overview.
What parameters can I change?
We have listed what each parameter does and how you can adjust it.
You can change the following parameters:
- Show category selector
- Image style
- Crop product images
- Products per page
- Products per row
- User can sort products
- Change button style
- Change button text
- Embed type
Show category selector
Shows a drop-down menu of all the categories in your Online Shop. It allows your visitors to see only products of a specific category.
Change the values to true to enable the drop-down menu or false to disable it.
Example:
showCategorySelector: true
Image style
Allows you to change the shape of your images on your shopfront.
You can choose between the following settings:
- Show images as squares: 'square'
- Show images in portrait mode: 'portrait'
- Show images in landscape mode: 'landscape'
- Show images in their original shape: 'actual'
Example:
imageRatio: 'square'
Crop product images
With this setting, you determine if you want to crop your images to the shape you have chosen as image style or if you want to fit the entire image inside a thumbnail while still maintaining the aspect ratio.
Change the value to true to crop images or false to fit the image in a thumbnail.
Example:
cropImages: true
Products per page
This setting determines the number of products displayed on the shop overview. It is also the number of products loaded when a customer clicks the "Load more..." button at the bottom of the product listing. Simply change the number to the number of products that should be shown.
Example:
productsPerPage: 15
Products per row
With this setting, you can determine how many products are displayed per row on the shop overview. The minimum is 2 products per row, and the maximum is 8. Simply change the number at the end of the parameter to your preference.
Example:
productsPerRow: '4'
User can sort products
With this setting, you decide if you want to show a drop-down menu in your shop that allows your visitor to change the sorting of products. The sort options are the same as the sort product settings. The visitor can, for example, search for the newest or cheapest products.
Change the values to true to enable the drop-down menu or false to disable it.
Example:
userCanSortProducts: true
Change button style
With this setting, you can change the style of the button. For example, you can make it larger or smaller or insert a class that adds different forms of visual weight.
Example:
buttonClassname: 'btn-myclass',
Change button text
With this setting, you can change the text inside the 'Buy' button. For instance, if you want it to say "Buy now" instead, you can simply change the text at the end of the parameter.
Example:
buyButtonText: 'Buy',
Embed type
This parameter contains internal information about your Online Shop. You don't need to change this parameter yourself; it will be done automatically, depending on how you publish your shop.
Example:
embedType: 'html'
Related articles:
