Embedding with HTML code
      Back to home
      1. Help Center
      2. Integration & Embedding
      3. Embedding with HTML code

      Customizing your embedded Rentle store

      How to customize your embedded store by editing specific parameters

      The rentle-store HTML element supports a variety of configuration parameters, which allow you to define among others which product or category should be displayed by default, or which language should be used. Rentle provides two options to get the correct code snippet to use in your html file.

      Option 1) Use the Embed Builder app

      The easiest way to get the correct parameters is to copy the code snippet from the Rentle Embed Builder. In the embed builder, you can simply navigate to the section of your online store which you would like to display on your website. Choose any location, category or product and click Copy Embed Code </> to view the correct code snippet to copy to your website.

      Option 2) Configure manually

      You can alsmo manually pass parameters to the rentle-store element with standard HTML syntax, for example: 

      <rentle-store 
        shop="myshop"
        store="mystorelocation"
        category="mycategory"
      />

       

      See the full list of possible parameters, applicable values and their respective behaviors below. Please note that the shop parameter is the only required parameter.

      Parameter Value Default
      shop

      The name of the shop to embed; It can be found via Account > Domains & URLs > Rentle domain path

      e.g. shop="myshop"

      		 None
      store

      The name of a specific store location to embed; find via Account > Domain & URLs > URLs > Store URL endings

      Applicable only when operating multiple store locations. 

      e.g. store="mystorelocation"

      		 None
      locationsview

      If you have multiple store locations and want to display all the store options for the customer to select from, set to TRUE

      e.g. locationsview= "true"

      		 None
      lang

      By default, the embed uses the system/browser language of the user viewing it, but if that is not available, your Rentle Admin's main language will be used as fallback. 

      The language parameter can take in any two-letter language code as the value. Just make sure, the respective language is activated in your Rentle store or no changes will be applied.

      e.g. lang="de"

      		 User language
      height

      By default, the height of the embedded store is automatically resized to fit the content within. This improves user experience, as it removes the need for a scrollbar within the embedded store.

      If you want, you can also set a fixed height for your embedded store by passing in a valid HTML height as the value of this parameter

      e.g. "1000px" or "100%" or "100vh"

      		 None
      category

      The ID of a specific category can be found via Catalog > Category > the URL ending of the respective category

      e.g. category="FH6YfXO0QBRDAVHAmB4P"

      		 None
      ticket

      The ID of a specific ticket product to show in the embed by default (requires Skidata integration).

      		 None
      product

      The ID of a specific product can be found via Catalog > Product > URL ending of the respective product; If provided, the category and ticket parameters will be ignored.

      e.g. product="Y13DRwOtR2vC7APRJab8"

      		 None
      disableautoscroll

      By default, your website user is automatically scrolled to the top of the embedded store when the page changes or a dialog is shown inside the embed. This improves user experience in most cases, but you can disable this behavior by passing in "true" as the value of this parameter.

      e.g. disableautoscroll="true"

      		 false
      disableheightanimation

      By default, when the height of the embedded store changes, the height is animated to its new value to prevent stutter. You can disable this behavior by passing in "true" as the value of this parameter.

      dsableheightanimation="true"

      		 false