> For the complete documentation index, see [llms.txt](https://bogos-guideline.gitbook.io/user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bogos-guideline.gitbook.io/user-guide/integration/themes.md).

# Themes

### What each tool does

#### BOGOS:

* Create, run, and manage offer types: Free Gifts, Bundles, Upsell & Discounts.
* Display and manage promotion widgets: Gift sliders, bundle page, discount widget, and promotional messages.
* Apply eligibility rules: Control which customers, products, collections, or cart conditions qualify for each promotion.

#### Theme:&#x20;

* Controls the store’s visual layout, templates, and interactive components (including the cart drawer, product pages, and cart/checkout display).&#x20;
* The theme determines where and how UI elements appear and how customers interact with the cart.

### What the integration enables

**Smooth gift handling in the cart drawer:** &#x20;

When BOGOS adds or removes a gift, the theme’s cart drawer updates correctly (shows the gift, remove controls, updated totals) without forcing a page reload or extra merchant setup.\
\
**Secure, reliable display:**&#x20;

Theme-level integration ensures BOGOS elements render within the store templates safely (avoids broken snippets or missing widgets) so gifts and messages show only when appropriate.\
\
**Less manual configuration:**&#x20;

Merchants don’t need to edit theme code to get working gift flows—integration handles placement and behavior so offers work out of the box.\
\
**Consistent UX across devices:**&#x20;

Because the theme controls responsive behavior, BOGOS gift interactions (drawer behavior, messages, remove controls) remain consistent on desktop and mobile, reducing confusion and cart friction.

### Integrated Labels & Badges apps

* [Zest – Shopify Theme](https://themes.shopify.com/themes/zest/styles/gusto?utm_source=BOGOS\&utm_medium=inapp\&utm_campaign=partnership)
* [Soul by Halo Themes](https://themes.shopify.com/themes/soul/styles/elegant?locale=en\&surface_detail=templates\&surface_inter_position=1\&surface_intra_position=21\&surface_type=templates)
* [Roar Theme](https://roartheme.co/)
* [Sleek Theme](https://themes.shopify.com/themes/sleek/presets/sleek?utm_source=BOGOS\&utm_medium=InappBanner\&utm_campaign=partnership)

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://bogos-guideline.gitbook.io/user-guide/integration/themes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
