Tolstoy

Use Tolstoy on your Nyla site

Nyla's integration with Tolstoy enables you to use their widgets on your site, along with supporting add to cart functionality. 

Activation Instructions

  1. To enable your app on Nyla, you should go to Apps > Tolstoy, enter the activation instructions and then save + publish the app. 
  2. In order to get the Tolstoy App Key from the Tolstoy dashboard: 
    1. See instructions here on how to find this. If you can't find your App key, please reach out to Tolstoy support.    
    1. Copy the App key field and paste into the corresponding field in Nyla, then save and publish the app. 



Adding Tolstoy to your site:  

Once Tolstoy is enabled you can use the Tolstoy content item to add your Tolstoy widgets to your site. 


Nyla supports the following 5 different layouts, which correspond to how they are categorized  in the Tolstoy dashboard:

  • Carousel
  • Stories
  • TV Page
  • Hero
  • Widget

For all 5 you will need the Publish ID that you can find in Tolstoy dashboard: 

  • Click on OnSite
  • Select a Layout type
  • Click on one of your created widgets or create a new one (note it must be in the Published state)
  • Click on Published which opens a dropdown
  • Check Step 3 where you can find your publish id
  • Copy and paste the publish id in the Tolstoy content item field in Nyla.

    VERY IMPORTANT: If you want to show all videos from the selected playlists on your product pages, regardless of whether they are tagged with that specific product or not, it will be necessary to enable the option "Allow non-tagged videos on PDPs."
  • In Tolstoy > OnSite > Click on the playlist that you want to enable the option "Allow non-tagged videos on PDPs." Click on Settings (gear icon) and enable the option "Allow non-tagged videos on PDPs."

If you have issues finding your Publish ID, please reach out to Tolstoy support. 


The Hero layout has 3 additional fields:

  • Hero ratio: Set the aspect ratio of the widget. The width will be fixed to 100% and anything you put on Hero width or Hero height will be ignored. Only number/decimals are allowed here
  • Hero width: Set the width of the widget. Any CSS width value is allowed. Eg: 100px, 50%, 50wh.
  • Hero height: Set the width of the height. Any CSS height value is allowed. Eg: 100px, 50%, 50vh.


Caveats: 

  • As per Tolstoy's implementation, the TV Page widget places itself above everything else in the page, so users won’t be able to see either the cart, or anything else in your site. Add to cart will remain working as long as this widget page is stored under the same domain as anything else in your site.

 

Nyla works with a variety of frontend apps, powering your site for everything up to checkout. Learn more about Nyla & Apps here. All third party apps are managed by the app themselves, meaning that Nyla integrations and use of these apps is limited to making them available on your Nyla site. Should you have any questions beyond our below guide about 3P app management, customization options, or general functionality, please reach out to the app directly.