For the complete documentation index, see llms.txt. This page is also available as Markdown.

Settings

1. General settings

  • BOGOS status: Enable BOGOS status for app to work on your online store.

  • Timezone: Time will be displayed based on your device's timezone

  • App language: Change app language to match with your native language

2. Gift logic mechanism

Changing the logic will affect all offers and remove any existing cloned products from your store. You may need to re-enable offers once the app completes the logic switch.

BOGOS recommends contacting support before changing the logic to ensure a smooth transition.

BOGOS offers two gift logic mechanisms:

2.1. Clone Product (Default)

When a gift offer is created, BOGOS automatically creates a duplicate (a "clone") of the original gift product in the merchant's Shopify product catalog.

These cloned products/gifts:

  • are hidden from the storefront/store search

  • are tagged "bogos-gift"

  • adds that cloned copy to the cart instead of the original products.

Because it's a separate product entry, it gives BOGOS much more flexibility: hide gifts from search (to make a mystery gift), unique image/title for those cloned gifts, no limit on number of gift offers created,...)

2.2. Gift Function

Gifts are added to the cart as your original Shopify products, discounted via Shopify's native discount function.

For example: it can't exceed the 100 discount limits across store.

3. Gift condition

3.1. Automatically add gift to cart

When there is only one gift selected in the offer, this gift will be automatically added to customers' carts. If you disable this feature, gift products will always show up in a gift slider.

3.2. Gift discount calculated by

The gift discount percentage can be calculated based on the Current price or the Compare-at price.

3.3. Gift price must be less than/equal to products

This feature restricts customers to only getting gifts at a lower price than the items in their cart. The gift item's price can be calculated based on the Current price or the Compare-at price.

3.4. Limit one selection per gift

This feature restricts customers from picking a gift item a Second time from the gift slider. They can no longer select this gift item even if they meet the conditions of other offers with the same gift.

3.5. Exclude added product

This feature restricts customers from getting a gift if they already have the same item in the cart.

4. Gift product

Setting inherit information of gift product from the original product

4.1. Delete gift products after turning off the offers

This feature is always enabled by default, so all cloned products can be removed after deactivating the offers.

4.2. Include compare-at price in gift product

If you enable this feature, the gift product will show. Once this setting is enabled, the gift product will show up with a crossed price on the customer's cart.

4.3. Gift products' SKU/Barcode format

By default, the gift products cloned by our app will have the same as the original SKU/Barcode.

You can also customize your SKU/Barcode format between the following options:

  • Same as original product

  • Same as original product with a suffix. E.g., SKU (100%OFF)

  • Blank

This will help if you use an inventory management system or 3rd party fulfillment for your store.

4.4. Gift product title format

Please choose your preferred format, it would be among the 3 below. Please reactivate the offers once you've changed this setting.

4.5. Sale channels

By default, the gift products will be published only on Online Store. If you have other sales channels such as POS or Mobile app, you can automatically publish them using this feature.

4.6. Include other original product details

By default, we will not duplicate the information on the original products in the gift products. However, this setting allows you to automatically include them.

  • Product type

  • Tags

5. Gift inventory management

5.1. Track and adjust the cloned gift's inventory

By default, the cloned gift's inventory is not tracked, so gifts can keep being added to carts as long as the offer is running.

If you want to limit how many gifts can be given out, you can track and input inventory directly on the cloned product:

  1. Go to Shopify admin > Products.

  2. Open the cloned gift's page.

  3. Enable Inventory tracked.

  4. Input the inventory quantity.

5.2 Deduct inventory from original product

This setting controls whether BOGOS deducts inventory from the original product when a cloned gift is purchased or not.

  • If turned off: BOGOS only deducts inventory from the cloned product.

  • If turned on: BOGOS deducts inventory from both the cloned product and the original product, so the original product’s inventory stays in sync with gift usage. The offer will then stop or continue based on the original product’s inventory settings in the Shopify admin.

5.3 Display out-of-stock gift items

This setting controls how out-of-stock gifts appear in the BOGOS gift slider.

Select one of the 2 options:

  • Hide out-of-stock items: Out-of-stock gifts are hidden from the gift slider.

  • Show out-of-stock items with an Out-of-stock status: Out-of-stock gifts remain visible on the gift slider, marked with an Out-of-stock status.

6. Advanced/ Draft-Order API

Draft-Order API is used for customer to checkout with original price at a discount instead of the gift products. Read more about Draft-Order API here.

Draft-Order API allows you to control how discounts apply to draft orders with an option to enable or disable discounts.

  • Allow: This option enables the combination of automatic discounts or discount codes with the draft order created by the BOGOS app.

  • Do Not Allow: This option blocks discounts when a gift is already included in the draft order, maintaining the previous behavior.

7. Fraud protection

7.1. Notify via email

You can receive email notifications about fraud orders. The email will contain a summary of the order considered fraudulent.

7.2. Activate Fraud protection with Orders

To activate this feature, you must first grant us permission to edit orders. By clicking Continue, you will be redirected to Shopify's access-granting page.

There are two levels of protection, you can enable the one that works with your store's situation.

Basic protection

When you enable this level of protection, the app will automatically cancel orders with only gifts and no other condition products.

Advanced protection

When you enable this level of protection, the app will re-check all the orders based on their offer status and offer main conditions.

If BOGOS detects orders include gifts taken from expired, scheduled offers, or the number of gifts appears suspicious then the app can automatically do one of the following actions:

  • Hold fulfillment

  • Cancel order

7.3. Activate Fraud protection with Cart and Checkout

BOGOS has integrated the Shopify Checkout Validation right into app settings. When you enable this feature, customers' carts must meet these conditions to successfully checkout in your store.

  • Minimum cart value: Customers can't checkout with gifts if their cart value is below this min

  • Minimum cart quantity: Customers can't checkout with gifts if their cart quantity is below this min

  • Maximum number of gifts per order: Customers can't checkout with gifts if their total gift number exceeds this max

Last updated