1.0 Overview

Integration of Bitsila and Urban Piper has allowed many restaurant businesses on the Urban Piper platform to access the benefits of ONDC through Bitsila’s Infrastructure.

Through this integration, the businesses can now sell their items on multiple ONDC buyer platforms and tap into a larger market with a wider range of customers compared to listing on just one online buyer platform.

However, in the world of online shopping, providing customers with one-of-a-kind and personalized experiences is highly important. You need the power of customization to craft a shopping experience that truly caters to your customers' requirements.

Today's shoppers want products that fit their style and what they like. Customization is not just something nice to have; it's something customers now want. When people can make a product that's just right for them, they're more likely to buy it.

This guide is designed to simplify things for you. It will show you how to customize your products on your Urban Piper account and how to make those changes reflect on ONDC platforms connected to your Bitsila system. You'll discover how to create new customizations for each product, offer choices to customers, and even enable them to make important decisions that suit their needs.

1.1 What is the customization and why it's needed?

Customization

Customization in the context of e-commerce is providing your customers with the ability to personalize and modify the products they purchase on the buyer platform. 

Customizations enable customers to modify some aspects of the product to suit their tastes and preferences. For example, if someone is ordering a pizza from a Restaurant, they can choose how their crust must be made, what toppings should be added to it, and what size the pizza should be. 

The customers are enabled to choose from a set of available options provided by the restaurant.

In this example, factors like Crust, Size, and Toppings fall under the Customizations.

Customization Options

Customization options are nothing but the choices you provide to your customers, from which they can choose what to add to the product they are ordering.

Following the example of pizza mentioned before, under each customization like Crust, Size, and Toppings, there would be multiple options.

Crust has Hand-tossed and Thin Crust, Size can be Regular, Medium, and Large, Toppings can be Grilled mushrooms, tomato, etc. All these fall under the Customization options.

Nested Customizations

If you provide Customization within the Customization options, then they are called Nested Customizations.

For a Pizza, the basic customization is the Crust with options like Hand-tossed and Thin Crust. For both of these options, the next step of customization is the sizes, which means both of these crust types are available in different sizes let’s say Regular, Medium, and Large 

So, a customer can order a Hand-tossed Regular Pizza with the Nested Customization.

Following this example, let’s go through the process of Creating these customizations, adding these options, and Creating these customization

First, let’s take a look at what these customizations look like at your end product. Let’s take a pizza product called Veg Extravagant Pizza for example. For a pizza, there could be multiple customizations.

The crust, size, toppings, etc. This will allow customers to choose how they want their pizza. 

Here is an example of how a pizza customization works on a Buyer app.

The above animation shows the three levels of Customization. The basic and first customization is the Crust which is followed by the nested customization of Size and finally another nested customization of toppings.

Let’s break down that example and the format of customization can be represented in the following tabular form

1.2 Customization Terminology on Urban Piper

Now that you understand what Customization, options, and nested customizations are, you need to understand what these terms are addressed as in Urban Piper’s Interface.

Modifier Group = Customization

Modifier group is the group in which you are offering a list of Customization options for your customers to choose from. 

In the case of the above-mentioned Pizza example, the Crust, Size, and toppings, are all Modifier groups.

Modifier = Customization Option

Modifiers are the actual Customization options provided under the Modifier groups. 

In the case of the above-mentioned  Pizza example, the contents within the Modifiers groups are the options. So, for Crust they are New Hand-tossed and 100 % Wheat thin crust, for the size they are Regular, Medium, and Large, for Toppings they are Grilled Mushrooms, Fresh Tomato, and Pepper Barbeque Chicken.

Nested Modifier = Nested Customization

As the name implies this is the Modifier added within the Modifier, i.e., Customization within the Customization. In the above example, Crust is the Parent Modifier and Size is a nested modifier for the crust. At the same time, Toppings are a nested modifier for the size.

To offer this form of customization, you need to create three different Modifier Groups  named Crust, Size and Toppings.

The Crust Modifier Group should have two Modifiers - New Hand Tossed and 100 % Wheat Thin Crust and customers can only choose one of them.

The Size Modifier Group should have three Modifiers - Regular, Medium, and Large. However, as you can see the 100% Wheat Thin Crust only has regular and medium options. So, it shouldn’t be available in Large. Customers can only choose one of the sizes.

The Toppings Modifier Group should have three Modifiers - Grilled Mushrooms, Fresh Tomato, and Pepper Barbeque Chicken. Customers can choose up to two toppings.

Before we proceed forward to go through the Customizations make sure the following requirements are met

1. Your Urban Piper Account should be Integrated with Bitsila system.

2. You need to have an active catalog on your Urban piper account synced with the Bitsila system.

3. You need to have added the outlet locations on your Urban piper account synced with bitsila system

To check if your Urban Piper Account is Integrated with Bitsila, you can do this quick backhand check. 

Go to locations module and click on the dropdown of All Platforms, if you can see Bitsila platform on the list, then Urban piper is synced with the Bitsila Platform.

2.0 Creating and Managing Customizations

2.1 Creating Modifier Group

1. Navigate to the Catalog Menu on the left-side panel of your Urban Piper- Atlas Platform

2. Click on the Modifier Groups Option

Now you can see the Modifier Groups Screen. You can see the list of all the pre-existing Modifier Groups. When you create new modifier groups, they will be added to this list

3. Click on the + Add Modifier Groups Button

Now you can see the Panel with the entry fields required to create a Modifier Group. 

4. Enter the Details

Fill in the following entry fields with the respective details

Title

Title as the name implies is the name of the Modifier Group that you are creating. The options or Modifiers that you are going to provide to your customers will be categorized and listed under this name.

For the current example we are following, we are going to create the Crust Modifier Group first. So, the Modifier Group Title is Crust.

Modifier Group Type

Modifier Group Type is a dropdown that has two options. Add-on and Variant.

Add-on is used when the customer can choose multiple options among the modifiers under this Modifier Group. 

Variant type is used when the customer can only choose one option among the modifiers under this Modifier Group.

For the Crust Modifier Group, we are creating now the users can only choose one crust for the pizza. So, we are going to use the Variant type

Sort Order

Sort Order is the numerical value you assign to the Modifier group to determine its position in the list of the Modifiers that you offer under the item. If the value is close to Zero, that means the modifier group is higher on the list, if the value is far from zero, then it is lower on the list

Crust is the first Modifier offering in this item. So, add 0 in the field

Is Default Toggle

If you turn on this toggle, the modifiers you add under this Modifier group will be the default. This means if you add the same group to different items the same Modifiers will be applied. If you don’t want these modifiers applied to the item, they can be removed manually.

For this example, we are setting the Modifiers to a default.

Multi Modifiers Enabled Toggle

This toggle enables you to add multiple Modifiers to the group. For this example, turn this on.

Description

In this field, you can add a detailed description of the Modifier group so that the customers will have a better understanding of the customization.

For this example, let’s add the description as follows

‘Choose the type of your Crust based on your test. If you want your crust soft and stretchy pick New hand-tossed and if you want a crunchy base, choose 100% Wheat thin crust.

CRM Title

The CRM title is the short text to easily search and identify the Modifier Group

POS ID

It is the ID that only applies for third-party integrations. 

1. Click on the Create Button

The Modifier Group is now created. You will now see the panel with the Basic Information of the New Modifier Group you created.

Now, we have created the Modifier group needed for the first customization of the item.

For the example that we are following, it is the Crust. Now we need to create two more Modifier Groups named Size and Toppings

The process to create Size is the same as the Crust.

Add Size in the Title field, Select Variant in the Modifier Type dropdown, Enable Multiple modifiers, and set the modifiers to default.

Fill out the description and CRM title.

The process of creating the Toppings Modifier is just a little bit different

Unlike the Crust and the Size where the customers could only choose one option in each group. 

Toppings are where the customers should be able to choose multiple options. So, we will select the Modifier type as an Add-on in the dropdown.

If you are selecting Add-on then you need to add Minimum Range and Maximum Range of Modifiers

Minimum Range Modifiers is the minimum number of Toppings the customer needs to add to the item to process the order. 

Maximum Range of Modifiers is the Maximum number of Toppings the customer can add to the item.

For the current example, the minimum number is 0 and the maximum is 2. 

Set those ranges and proceed forward to create the Modifier Group

After you create the Modifier groups, you can go back to the Modifier Groups section and search for the groups in the list.

2.2 Creating Modifiers

Once you created the Modifier Groups, it is time for you to create the Modifiers that will go under these Modifier Groups.

1. Navigate to the Catalog Module on the left-side panel

2. Click on Modifiers Option

You will see the Modifiers screen where you can access the list of modifiers in your account. When you create a new modifier it will appear in this list.

3. Click on +Add Modifier Button

You can now see a Panel to enter the details

Title as it implies is where you add the name of the Modifier

Food Type is a dropdown menu where you can select if the food is veg, non-veg, egg, and if neither of those, you can choose NA

Default Price is where you add the price of this option

Sort order is the same as it is with the Modifier group. Number close to 0 means it will appear higher on the list and a number away from 0 means lower on the list

Just like how you did with the Modifier group, add the Description, CRM title, Tags if any, and other details.

1. Enter the Details and Click on Create at the Bottom

For the current example, we are now creating modifiers for the three groups Crust, Size, and Toppings

For the Crust group, we have two modifiers

New Hand-tossed and 100 % Wheat thin crust

First let’s proceed with the New Hand-tossed, with 0 as the sort order.

Click on Create to finish creating the Modifier Button.

To create more modifiers, you can repeat the process by clicking on the +Add Modifier Button on the top-right

After that, proceed to create 100 % Wheat thin crust, with 1 as the sort order.

In the same way create the Modifiers for other Modifiers group as well

For Size: Regular with sort order 0, Medium with sort order 1, Large with sort order 2.

For Toppings: Grilled Mushrooms with sort order 0, Fresh Tomato with sort order 1, Pepper Barbeque chicken with sort order 2.

Once the Modifiers are created, you can search for them in the Modifiers list through the search bar.

2.3 Adding Modifiers to the Modifier Groups

When your Modifiers Groups and Modifiers are both ready, you can associate them together. This means you can add the Modifiers to the respective groups. Navigate to the Catalog Module on your Left-side panel and Click on Modifier option

1. Navigate to the Modifier Groups menu under the Catalog Module

2. Select the modifier group from the list by navigating or using the Search bar

For the example, let’s add the Modifiers for the Crust first

Click on the Crust, and you will see the Edit Modifier Panel

In that panel, you will see the Basic information of the Modifier Group and several other tabs.

3. Click on the Nested Modifiers Tab

You will see the search fields and the empty table on top of which you will find the Update button

4. Click on the Update Button

5. Search for the Modifiers through the Name field or CRM Title or navigate the list. Mark the checkboxes 

For Crust, the Modifiers are New Hand-Tossed and 100% Wheat Thin Crust

6. After Selecting the Modifiers Click on the Update Modifiers button on the top-right

Modifiers will be updated to the group and you can see in the table of the Nested Modifiers Tab.

For this example, we have two other groups for which you have to add the Modifiers.

For the Size Modifier group, add the Modifiers Regular, Medium, and Large

For the Toppings Group, Add the Modifiers Grilled Mushrooms, Fresh Tomato, and Pepper Barbeque Chicken.

Once the Modifiers are added to the groups, it is time to add them as Nested Modifiers.

2.4 Creating Nested Modifier Groups

When we are creating multiple levels of customizations, we need to add nested modifier groups.

For the current example, the Crust is the first Customization. So, the Size will be Nested under the Crust and the toppings will be nested under the size. In total creating a three-layered Customization.

Here is the process

1. Go to the Modifier Groups Section under the Catalog Module

2. Search for the Crust Modifier group and Click on it

3. Click on Nested Modifiers Tab

Here you can see the list of the Modifiers that are under the Crust Modifier Group

4. Click on the Modifier

In this case, first, let’s go with the New-Hand Tossed Modifier

5. In the Modifier Panel, Click on the Nested Modifier Groups Tab

6. Click on Update

7. Select the Nested Modifier Group and Click on Update on the top right

In this case, the Nested Modifier Group is the Size.

Once you update the Modifier group, you can see the Modifiers in the Nested Modifier Groups tab.

8. Click on the View button of this newly added Modifier Group

You will see the basic information of this Modifier Group in this case, the information of the Size Group

9. Click on the Nested Modifiers Tab

10. Select the Nested Modifier 

Now you will see the details of the Modifier you selected. In this case, you will Regular Modifier Details

11. Click on the Nested modifier Groups Tab

12. Click on Update

13. Search and Select the Modifier Group

In this case, it is toppings

14. Click on Update Modifier Groups

With this, you add the Size group under the Crust and Toppings group under the Crust

This creates the three-layer customization Crust→ Size→ Toppings

Once the Customizations are done, you can add this to the item.

2.5 Adding the Nested Modifier Group to the Item

1. Go to the Items Section under Catalog Module

1. Search for the Item or Navigate through the item list and Click on it

Here the item name is Veg Extravaganza Pizza.

2. In the Item Panel, Click on the Modifier groups tab.

3. Click on Update

4. Search for the Modifier group in the search field

Here we are using the Name Crust

5. Click on the Check box of the Modifier Group and Click on Update

The Modifier group is added

Now the Nested Customizations are added to the item

Finally, you need to sync it with your Outlet locations to make it available on the ONDC platforms

2.6 Syncing the Customizations to ONDC Outlets

1. Go to the Items Section under Catalog Module

2. Search for the Item or Navigate through the list and Click on it

Here the item name is Veg Extravaganza Pizza.

3. In the Item Panel, Click on Locations tab

4. You will see all the locations that this item is currently available in. Select the locations you want to sync the changes to

5. Click on Mark locations Available Button

6. Go to the Locations Module

7. Select the Locations that you added the item for

8. Click on Publish

The items will be added to the selected locations with all the new modifications

You can verify if the new customizations have been reflected on your ONDC listings through your Bitsila account. Click here for the Verification Process.

3.0 FAQs

**1. What is the purpose of the integration between Bitsila and Urban Piper?**

   - The integration of Bitsila and Urban Piper allows restaurant businesses on Urban Piper to access the benefits of ONDC through Bitsila's infrastructure, enabling them to reach a wider range of customers on multiple ONDC buyer platforms.

**2. Why is customization important in e-commerce?**

   - Customization in e-commerce allows customers to personalize and modify the products they purchase, catering to their preferences. It's essential as it provides a unique and tailored shopping experience that customers now desire.

**3. What are customization options in the context of e-commerce?**

   - Customization options are the choices provided to customers to modify the product. For example, in the case of ordering a pizza, customization options include crust type, size, and toppings.

**4. What are nested customizations, and how do they work?**

   - Nested customizations refer to customizations within customizations. For example, for a pizza, the crust may have nested customizations for size, and size may have nested customizations for toppings.

**5. How are customizations represented in the context of a pizza order?**

   - Customizations for a pizza order can be represented in a tabular form, showing options for crust, size, and toppings, with different choices available for each category.

**6. What are Modifier Groups and Modifiers in Urban Piper's interface?**

   - Modifier Groups are categories that offer a list of customization options, while Modifiers are the actual customization options provided within these groups. For instance, for pizza, Crust, Size, and Toppings are Modifier Groups, and New Hand-tossed and 100% Wheat Thin Crust are Modifiers.

**7. What is a Nested Modifier in the context of customization?**

   - A Nested Modifier is a customization option added within another Modifier, creating a hierarchy of customizations. For example, Crust can have Size as a Nested Modifier.

**8. How do you create Modifier Groups in Urban Piper?**

   - To create Modifier Groups, go to the Catalog Menu, select Modifier Groups, and add a title, type, sort order, and other details. Then, add a description and set it as default if needed.

**9. How can Modifiers be added to Modifier Groups in Urban Piper?**

   - Modifiers can be added to Modifier Groups by navigating to the Modifier Groups section, selecting the appropriate group, and using the Nested Modifiers tab to associate Modifiers with the group.

**10. How do you sync customizations to ONDC outlets in Urban Piper?**

    - To sync customizations to ONDC outlets, go to the Items section, select the item, navigate to the Locations tab, and choose the locations where you want to apply the modifications. Then, mark the locations as available and publish the changes to make them effective on the ONDC platforms.