# Adjust BOGOS Blocks

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2Feztj5CYloDEZTtO6jDz8%2Funknown.png?alt=media&#x26;token=0e26c5eb-8cff-4009-8f7c-7036e8140f62" alt=""><figcaption></figcaption></figure>

Normally, certain BOGOS blocks will **automatically appear on your Shopify storefront.**

However, you **have to manually adjust BOGOS blocks** if you:

* Don't see the widgets on your preferred pages
* Use [Checkout Upsell](https://bogos-guideline.gitbook.io/user-guide/detailed-guide/upsell-offer/create-checkout-upsell) or [Thank You Page Upsell](https://bogos-guideline.gitbook.io/user-guide/detailed-guide/upsell-offer/create-thank-you-page-upsell)
* Want to change the widgets' position
* Want to add new blocks on product pages or other pages on your store

{% embed url="<https://www.youtube.com/watch?v=w4KFLP1cUgY>" %}

**Adjusting BOGOS blocks includes 6 essential steps:**

1. Navigate to your Theme Editor > [Choose the page where you want to add a block.](#choose-the-page-to-adjust-blocks)
2. Click [Add section or Add Block > Apps](#add-a-new-bogos-block).
3. Search for and select the BOGOS block you want.
4. [Enter offer/booster ID](https://bogos-guideline.gitbook.io/user-guide/user-guide/customize/customize-bogos-blocks#enter-id-if-required) (if required).
5. [Drag and drop the block](#move-an-existing-bogos-block) to your preferred location.
6. Click Save.

**For a more detailed guide**, please read the guide below:

### Choose the page to adjust blocks

Before adding or moving a BOGOS block, decide which page you want to display it on.

1. Go to Shopify admin > Online Store > Themes > Edit Theme.
2. At the center of the header, choose the page you want to edit.&#x20;

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2FJb9H9kjKbglxhcJSfemH%2Funknown.png?alt=media&#x26;token=6942bebc-491f-42c2-b527-51efe1a37f22" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Each page type supports different BOGOS blocks:**

* Product page (all BOGOS blocks)
* Homepage, Collection page, Cart page (specific blocks only)
* Checkout page (checkout upsell block - only for Shopify Plus)
* Thank you page (thank you upsell block)
* Custom page (specific blocks only)
  {% endhint %}

After navigating to the page you want to edit, you can begin adding or moving BOGOS blocks.

### Add a new BOGOS block

You can add a BOGOS block either **inside an existing section** or **as part of a new section**, depending on your theme layout and display preference.

1. Choose how you want to add the block:

* Click on the existing section, or
* Click Add section if you want to create a new one

2. Add block > Apps > Choose the block you want.

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2FTYvUWQJHzNkX0oAJ3DyF%2Fimage.png?alt=media&#x26;token=d93a8df4-c5f7-45d9-827d-a48ca2c05dc5" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Only blocks that work on that page will show up in the list. If a block does not appear in the list, it is not supported on that page.
{% endhint %}

2. [Enter offer/booster ID](#enter-id) (if required).
3. Drag and drop the block or the section to your preferred location.
4. Click Save.

### Move an existing BOGOS block

To change the position of a block inside an existing section:

1. Locate the section that contains the BOGOS block you want to move.
2. Drag and drop the block to your desired position within the section.
3. Click Save.

**Note:**&#x20;

* Blocks can only be moved within their current section.&#x20;
* If you want to **move a block to a different section**, you’ll need to:

1. Select and delete the existing BOGOS block.
2. Locate the new section > Add Block > Apps.
3. Search and reselect the block you want to move.
4. Drag and drop the block to your preferred location.
5. Click Save.

### Enter ID (if required)

An offer ID or booster ID is a unique identifier for each offer and booster in BOGOS. It allows you to display the correct block with the ID you enter.

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2FnZt4XAd2bNJhJlnTAN2f%2Funknown.png?alt=media&#x26;token=10696bde-81ff-451a-aeb0-34e3e83125b6" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Certain features, like the gift slider, checkout upsell, and gift thumbnail, don’t allow entering an ID. Instead, these blocks will automatically appear when customers meet the specified conditions.
{% endhint %}

<details>

<summary><strong>🔻 On the product page, ID is optional</strong></summary>

**In most cases, you don't need** to enter an ID on product page&#x73;**.** BOGOS automatically matches and displays the widget with relevant content for that product.&#x20;

E.g: a Classic Bundle widget will auto-appear on product pages for all products included in that bundle.

**You only need to enter** an ID if:

* You have multiple [Progress Bars](https://bogos-guideline.gitbook.io/user-guide/detailed-guide/boosters/create-progress-bar) or [Today Offer blocks](https://bogos-guideline.gitbook.io/user-guide/detailed-guide/boosters/create-today-offer-block), and you want to display the correct one on each product page. (If you don't specify an ID, all Progress Bars or Today Offer blocks will be shown by default.)
* You want to display a different block instead of the one BOGOS automatically selects.

</details>

<details>

<summary><strong>🔻 On other pages, ID is compulsory</strong></summary>

When you add BOGOS blocks to the homepage, collection pages, cart page, or your custom pages, you **must enter** a specific ID to specify which block to display.

</details>

#### 🔻 How to find and enter an ID

1. Open BOGOS app > Navigate to the setup screen of the offer or booster you want to display.
2. Copy your ID at the end of the URL link (e.g, 15556)

<figure><img src="https://1174860429-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQEzvXIQmpPrTmxjT8T6%2Fuploads%2FTyZRhuiFYd98koByocO0%2Fimage.png?alt=media&#x26;token=ce6ea607-82a0-4cf8-b5ec-24a1d4fd271b" alt=""><figcaption></figcaption></figure>

1. In the Theme Editor, select the needed BOGOS block.
2. Locate the ID field in the block settings.
3. Enter the correct ID (e.g, 15556).
4. Click Save.

### Frequently Asked Questions (FAQs)

<details>

<summary><strong>Q1: Why doesn't my offer appear on my store even though it's enabled?</strong></summary>

**A1:** If your offer is enabled but not showing on your store, check the following:

* Verify if the conditions are met or not, as some widgets only show up when condition.. (for example, correct products, collections, or cart conditions).
* Make sure the offer block is added to your theme. Navigate to your Theme Editor and verify the BOGOS block appears on the page. If it doesn't show up, please [add the offer block](#add-a-new-bogos-block) to your page.
* If using an Offer ID, confirm you entered the correct ID in the block settings.

</details>

<details>

<summary><strong>Q2: How do I limit a widget to appear only on specific pages?</strong></summary>

**A2:** To display a BOGOS block on specific pages only, not all your pages, you will need to [create a custom page template](https://help.shopify.com/en/manual/online-store/themes/theme-structure/templates):

1. Go to Shopify admin > Online Store > Themes > Edit Theme.
2. Click the Home page drop-down menu > Choose Pages > Create template.
3. Customize the page as you want.
4. [Add the block](#add-a-new-bogos-block) you want to show up.

</details>
