Skip to main content
Skip table of contents

How to use e-commerce in OKO

This guide covers how to set up and use the e-commerce functionality in OKO via Shopify.

E-Commerce functionality can only be initially set up on OKO Web before assigning product ID’s in a space. You can add product ID’s via both OKO Web and using the OKO Unreal Plugin once setup is complete.

Setting up e-commerce

You can add or remove the e-commerce functionality either when creating or editing a space.

image-20260521-141526.png

To toggle on e-commerce when creating a space, start by pressing the "Create New Space" button in the upper right-corner. Then, in the Create Space Settings tab, enable ‘Commerce’ and proceed to create the space.

image-20260521-141712.png

You will now be taken through the flow to connect your space with Shopify.

Note that you will either require a paid Shopify plan or need to use shopify.dev to test e-commerce with OKO.

ECommerce_101_shopify_dev.png

Let’s use shopify.dev, to show the workflow from end to end. First, sign up for a dev account on shopify.dev (unless you already have a paid account on http://shopify.com ).

ECommerce_102b_Create_a_Shopify_Account_by_Email.png

Sign up with your preferred method. For this example, we’ll sign up using an email address.

image-20260521-142042.png

When you have entered all the requisite info, click on the “Stores” tab on the left to navigate to the “Stores” page. This is your Shopify Partners administration page. (If you don’t see a “Stores” tab, you need to make sure to use a paid or dev Shopify account, as this tab will not be visible with a free – even free trial – non-dev Shopify account.)

If needed, follow the flow to add your Shopify store.

ECommerce_119_Search_for_Headless.png

With a Shopify store selected, you will be taken to the store’s dashboard. Click on the “Sales channels” link label on the left, and search for “Headless”.

ECommerce_121_Headless_App.png

You will arrive at this page. Click “Install” to Install the Headless App.

ECommerce_125_Create_Storefront.png

Click “Create Storefront” to create a Headless storefront.

Notice the “Headless” link label on the left and the pin next to it. Click on the pin so the Headless channel stays visible to the left.

ECommerce_127_Manage_Headless_Storefront_API.png

Click “Manage” to the right of the Storefront API to manage the tokens.

ECommerce_128_PRIVATE_ACCESS_TOKEN.png

Save the “Private access token” in a safe place. You’ll need this to associate your OKO space with your store.

Make sure to copy the store URL, as this is also required.

image-20260521-143022.png

Next, back in OKO, proceed to Step 3 of the E-Commerce Setup flow.

Enter the information you gathered in Shopify.

image-20260521-143108.png

You should see that e-commerce is now connected in the settings page.

ECommerce_310_Add_Backpack.png

Now, go back to your store on the Shopify website. Delete any starter example products you don’t need and add your products to your store. Here’s a backpack as an example.

ECommerce_318_Place_Cylinder.png

Go back to OKO and enter your e-commerce space. In this example, we’ve added a cylinder mesh to our space to act as a pedestal for our product.

ECommerce_323_Add_ECommerce_Component_to_Backpack.png

Next, let’s add a backpack asset to the space and place it on the pedestal.

image-20260521-144424.png

Add an e-commerce component to the backpack and enter the product ID.

Testing your ECommerce Space

Enter Viewer Mode to test the e-commerce component you just added.

ECommerce_327_Enter_Play_Mode_to_Test.png

Select the e-commerce tag in Viewer Mode.

ECommerce_329_Select_Tag.png

Select the “Default Title” in the Variant to prepare for purchase (this will be simplified in a future release).

ECommerce_330_Select_Default_Title_in_Variant.png

With the “Default Title” selected, add the item to your bag.

ECommerce_331_Add_to_Bag.png

Note that the item has been added to your bag.

ECommerce_332_Added_to_Bag.png

Click on the Shopping Bag icon to go to checkout.

ECommerce_333_Click_on_Shopping_Bag.png

The item is ready to be purchased.

ECommerce_334_Checkout.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.