# Displaying express checkout buttons in cart
Source: https://docs.assortion.com/cart/express-checkout-buttons

Enable express checkout options for faster customer purchases

Express checkout buttons allow customers to skip the traditional checkout process and complete their purchase quickly using payment methods like Apple Pay, Google Pay, or Shop Pay.

## Implementation

To enable express checkout buttons in your cart, you'll need to add a small code snippet to your theme.

<Steps>
  <Step title="Access theme code">
    From your Shopify admin, go to **Online Store** → **Themes** → **Actions** → **Edit code**
  </Step>

  <Step title="Open theme.liquid">
    In the **Layout** folder, click on `theme.liquid` to open it
  </Step>

  <Step title="Add the code">
    Find the `</head>` closing tag and add the following code as a new line just before it:

    ```liquid theme={null}
    {% if additional_checkout_buttons %}
    <div style="display: none !important">
        {{ content_for_additional_checkout_buttons }}
    </div>
    {% endif %}
    ```
  </Step>

  <Step title="Save changes">
    Click **Save** to apply the changes to your theme
  </Step>
</Steps>

## How It Works

This code snippet:

* Checks if express checkout buttons are available (`{% if additional_checkout_buttons %}`)
* Renders the checkout button content in a hidden div
* Allows Assortion's cart to control when and how these buttons are displayed

<Info>
  The div is set to `display: none !important` so that Assortion can manage the visibility and positioning of express checkout buttons within your custom cart.
</Info>

## Benefits

<CardGroup>
  <Card icon="bolt" title="Faster Checkout">
    Customers can complete purchases in seconds
  </Card>

  <Card icon="mobile" title="Mobile Optimized">
    Perfect for mobile shoppers using digital wallets
  </Card>

  <Card icon="chart-line" title="Higher Conversion">
    Reduce cart abandonment with one-click purchasing
  </Card>

  <Card icon="shield-check" title="Secure Payments">
    Leverage trusted payment providers
  </Card>
</CardGroup>

## Supported Payment Methods

Express checkout typically supports:

* **Apple Pay** - For Safari and iOS users
* **Google Pay** - For Chrome and Android users
* **Shop Pay** - Shopify's accelerated checkout
* **PayPal** - Express checkout option
* **Amazon Pay** - If enabled in your store

<Note>
  Available express checkout options depend on your payment gateway settings and customer's browser/device.
</Note>

## Troubleshooting

| Issue                 | Solution                                                    |
| --------------------- | ----------------------------------------------------------- |
| Buttons not appearing | Ensure payment providers are properly configured in Shopify |
| Wrong positioning     | Check that the code is placed before `</head>`              |
| Duplicate buttons     | Remove any other express checkout code from your theme      |

## Need Help?

If you need assistance with express checkout buttons, contact our support team at [support@assortion.com](mailto:support@assortion.com).


# Combining Discounts
Source: https://docs.assortion.com/discounts/combining-discounts

Learn how to combine manually created discounts with Assortion discounts

You can combine manually created discounts (like welcome discounts or seasonal promotions) with Assortion's automatic discounts. This allows you to offer multiple discount types simultaneously to maximize conversions.

## Prerequisites

To combine discounts, you need to configure settings in both:

1. Your Shopify admin discount settings
2. Your Assortion widget settings

## Configuration Steps

<Steps>
  <Step title="Configure Shopify Discount">
    ### Make your Shopify discount combinable

    1. Navigate to **Discounts** in your Shopify admin
    2. Find and click on your discount code
    3. Scroll down to the **Combinations** section
    4. Check the **Product discounts** option
    5. Save your changes

    <Info>
      This allows your manual discount to combine with product-level discounts from Assortion
    </Info>
  </Step>

  <Step title="Configure Assortion Widget">
    ### Enable combination in Assortion

    1. Go to your Assortion dashboard
    2. Edit the widget you want to configure
    3. Navigate to the **Options** section
    4. Check **"Allow discount to be combined with other discounts"**
    5. Save your widget settings

    <Warning>
      Make sure both settings are enabled for discounts to combine properly
    </Warning>
  </Step>
</Steps>

## How It Works

When both settings are enabled:

* Customers can use a manual discount code (e.g., WELCOME10)
* Assortion discounts (volume, bundle, etc.) will still apply
* The discounts stack, giving customers the best possible deal

## Common Use Cases

<CardGroup>
  <Card icon="percent" title="Welcome + Volume">
    Combine a new customer discount with volume pricing tiers
  </Card>

  <Card icon="gift" title="Seasonal + Bundle">
    Stack holiday promotions with bundle discounts
  </Card>

  <Card icon="tags" title="VIP + Product">
    Apply VIP customer codes alongside product-specific offers
  </Card>

  <Card icon="users" title="Referral + Upsell">
    Use referral discounts with upsell promotions
  </Card>
</CardGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="Test discount combinations">
    Always test your discount combinations to ensure they calculate correctly and don't over-discount your products.
  </Accordion>

  <Accordion title="Set clear limits">
    Consider setting maximum discount limits to protect your margins when combining multiple discounts.
  </Accordion>

  <Accordion title="Communicate clearly">
    Make sure customers understand which discounts can be combined to avoid confusion at checkout.
  </Accordion>
</AccordionGroup>

## Troubleshooting

| Issue                   | Solution                                               |
| ----------------------- | ------------------------------------------------------ |
| Discounts not combining | Verify both Shopify and Assortion settings are enabled |
| Wrong calculation       | Check discount priority settings in Shopify            |
| Customer confusion      | Add clear messaging about combinable discounts         |

<Note>
  Discount combination rules follow Shopify's native discount priority system. Percentage discounts typically apply before fixed amount discounts.
</Note>

## Need Help?

If you need assistance with combining discounts, contact our support team at [support@assortion.com](mailto:support@assortion.com).


# Privacy Policy
Source: https://docs.assortion.com/documents/privacy-policy

Privacy policy for Assortion

*Last Updated: June 8, 2024*

Assortion "the App” provides AI based product sourcing "the Service" to merchants who use Shopify to power their stores. This Privacy Policy describes how personal information is collected, used, and shared when you install or use the App in connection with your Shopify-supported store.

### Personal Information the App Collects [​](https://docs.assortion.com/legal/privacy-policy#personal-information-the-app-collects) 

When you install the App, we are automatically able to access certain types of information from your Shopify account: products, orders, inventory, fulfillments.

Additionally, we collect the following types of personal information from you and/or your customers once you have installed the App: your business information and payment/payout methods (we use Stripe to store payment and business profile information), shoppers’ interaction with our product offerings; Information about you and others who may access the App on behalf of your store, such as your name, address, email address, phone number, and billing information; Information about individuals who visit your store, such as their IP address, web browser details, time zone, and information about the cookies installed on the particular device.

We collect personal information directly from the relevant individual, through your Shopify account, or using the following technologies: “Cookies” are data files that are placed on your device or computer and often include an anonymous unique identifier. For more information about cookies, and how to disable cookies, visit  [http://www.allaboutcookies.org.](http://www.allaboutcookies.org./)  “Log files” track actions occurring on the Site, and collect data including your IP address, browser type, Internet service provider, referring/exit pages, and date/time stamps. “Web beacons,” “tags,” and “pixels” are electronic files used to record information about how you browse the Site.

### How Do We Use Your Personal Information? [​](https://docs.assortion.com/legal/privacy-policy#how-do-we-use-your-personal-information) 

We use the personal information we collect from you and your customers in order to provide the Service and to operate the App.

### Sharing Your Personal Information [​](https://docs.assortion.com/legal/privacy-policy#sharing-your-personal-information) 

We may share your Personal Information to comply with applicable laws and regulations, to respond to a subpoena, search warrant or other lawful request for information we receive, or to otherwise protect our rights.

### Data Retention [​](https://docs.assortion.com/legal/privacy-policy#data-retention) 

When you place an order through the Site, we will maintain your Order Information for our records unless and until you ask us to delete this information.

### Changes [​](https://docs.assortion.com/legal/privacy-policy#changes) 

We may update this privacy policy from time to time in order to reflect, for example, changes to our practices or for other operational, legal or regulatory reasons.

### Contact Us [​](https://docs.assortion.com/legal/privacy-policy#contact-us) 

For more information about our privacy practices, if you have questions, or if you would like to make a complaint, please contact us by e-mail at  [support@assortion.com](mailto:support@assortion.com) .


# Installing widgets to your store
Source: https://docs.assortion.com/getting-started/installing-widgets

Learn how to install Assortion widgets on your Shopify store

Widgets will automatically find their positions on your store and display once you've created and made them active. There are several ways to install widgets depending on your theme type and preferences.

## Installation Methods

<Tabs>
  <Tab title="Online Store 2.0">
    For modern themes, use app blocks for the cleanest installation:

    ### Available App Blocks

    * **FBT Bundle** (Frequently Bought Together)
    * **Product Add-ons**
    * **Volume Discount**

    <Note>
      App blocks are currently only supported on product pages. They don't modify your theme code and are automatically removed when the app is uninstalled.
    </Note>

    [Learn how to set up app blocks →](/getting-started/setup-app-blocks)
  </Tab>

  <Tab title="Vintage Themes">
    For older themes, widgets can be positioned using CSS selectors. Contact our support team for assistance with custom positioning.
  </Tab>

  <Tab title="Page Builders">
    If you're using page builders like PageFly or GemPages, you can embed widgets using HTML snippets.

    [Learn about page builder integration →](/getting-started/integration-with-page-builders)
  </Tab>
</Tabs>

## Widget HTML Snippets

If you need to manually place widgets or are using page builders, use these HTML snippets:

### Volume Discount

```html theme={null}
<div id="ast-vd-container"></div>
```

### Frequently Bought Together

```html theme={null}
<div id="ast-bundle-container"></div>
```

### Product Add-ons

```html theme={null}
<div id="ast-addon-container"></div>
```

## Key Benefits

<CardGroup>
  <Card icon="code-branch" title="No Code Modifications">
    App blocks don't modify your theme code, keeping your store clean
  </Card>

  <Card icon="trash-undo" title="Clean Uninstall">
    Widgets are automatically removed when the app is uninstalled
  </Card>

  <Card icon="location-dot" title="Smart Positioning">
    Widgets automatically find optimal positions on your pages
  </Card>

  <Card icon="toggle-on" title="Easy Control">
    Enable or disable widgets anytime from your dashboard
  </Card>
</CardGroup>

## Need Help?

If you need assistance with widget installation, our support team is here to help at [support@assortion.com](mailto:support@assortion.com).


# Integration with page builders
Source: https://docs.assortion.com/getting-started/integration-with-page-builders

Integrate Assortion with PageFly, GemPages, and other page builders

If you're using a page builder to create custom product pages, you can easily integrate Assortion widgets using HTML snippets.

## Widget HTML Codes

Copy and paste these HTML snippets into your page builder:

<CodeGroup>
  ```html Volume Discount theme={null}
  <div id="ast-vd-container"></div>
  ```

  ```html Frequently Bought Together theme={null}
  <div id="ast-bundle-container"></div>
  ```

  ```html Product Add-ons theme={null}
  <div id="ast-addon-container"></div>
  ```
</CodeGroup>

## Page Builder Instructions

<Tabs>
  <Tab title="PageFly">
    ### Adding widgets to PageFly

    1. Open your page in the PageFly editor
    2. Add an **HTML/Liquid** block where you want the widget
    3. Paste the appropriate HTML snippet from above
    4. Save and publish your page

    <Card icon="external-link" title="PageFly Documentation">
      [Learn more about using HTML blocks in PageFly →](https://help.pagefly.io/manual/getting-started-with-pagefly/using-html-liquid-block)
    </Card>
  </Tab>

  <Tab title="GemPages">
    ### Adding widgets to GemPages

    1. Open your page in the GemPages editor
    2. Add a **Liquid** block to your page
    3. Paste the appropriate HTML snippet from above
    4. Save and publish your page

    <Card icon="external-link" title="GemPages Documentation">
      [Learn more about using Liquid blocks in GemPages →](https://help.gempages.net/en/article/liquid-block-2058092)
    </Card>
  </Tab>

  <Tab title="Other Builders">
    ### General instructions

    Most page builders support custom HTML or Liquid blocks:

    1. Look for an HTML, Custom Code, or Liquid block option
    2. Add the block where you want the widget to appear
    3. Paste the appropriate HTML snippet
    4. Save and publish your changes

    <Tip>
      If your page builder doesn't support HTML blocks, contact their support team for guidance on adding custom code.
    </Tip>
  </Tab>
</Tabs>

## Widget Placement Tips

<AccordionGroup>
  <Accordion title="Optimal placement locations">
    * **Volume Discount**: Near the product price or quantity selector
    * **Frequently Bought Together**: Below the main product information
    * **Product Add-ons**: Above or near the add to cart button
  </Accordion>

  <Accordion title="Multiple widgets on one page">
    You can add multiple widgets to the same page. Each widget will automatically detect and display relevant offers based on your configuration.
  </Accordion>

  <Accordion title="Mobile optimization">
    All Assortion widgets are fully responsive and will adapt to mobile layouts automatically.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<Warning>
  Make sure you're adding the HTML snippet to a product page or a page that has product context. Widgets won't display on pages without product information.
</Warning>

### Common Issues

| Issue              | Solution                                               |
| ------------------ | ------------------------------------------------------ |
| Widget not showing | Ensure the offer is active in your Assortion dashboard |
| Wrong position     | Try placing the HTML block in a different section      |
| Display issues     | Clear your browser cache and refresh the page          |

## Need Help?

If you need assistance integrating with your specific page builder, contact our support team at [support@assortion.com](mailto:support@assortion.com).


# Setup app blocks for Online Store 2.0 themes
Source: https://docs.assortion.com/getting-started/setup-app-blocks

Configure app blocks for modern Shopify themes

App blocks are the recommended way to add Assortion widgets to your Online Store 2.0 theme. They provide a clean, code-free installation that's easy to manage.

<Info>
  App blocks are currently only supported on product pages. Support for other page types is coming soon.
</Info>

## Step-by-Step Installation

Follow these steps to add app blocks to your theme:

<Steps>
  <Step title="Access your store">
    Log in to your Shopify store admin panel
  </Step>

  <Step title="Navigate to theme editor">
    Go to **Online Store** in your Shopify admin
  </Step>

  <Step title="Customize your theme">
    Click the **Customize** button to open the theme editor
  </Step>

  <Step title="Select product template">
    Navigate to **Products** → **Default product** from the page selector
  </Step>

  <Step title="Find the right section">
    Locate the section where you want to add the app block (e.g., near the add to cart button)
  </Step>

  <Step title="Add the app block">
    Click **Add block** or **Add section** in your chosen location
  </Step>

  <Step title="Select Assortion app">
    In the **APPS** section, choose one of these app blocks:

    * **FBT Bundle** (Frequently Bought Together)
    * **Product Add-ons**
    * **Volume Discount**
  </Step>

  <Step title="Position the block">
    Drag and drop the app block to your desired position
  </Step>

  <Step title="Save your changes">
    Click **Save** and refresh your store pages to see the changes
  </Step>
</Steps>

## Available App Blocks

<CardGroup>
  <Card icon="boxes-stacked" title="FBT Bundle">
    Display frequently bought together product recommendations
  </Card>

  <Card icon="plus-circle" title="Product Add-ons">
    Show complementary products as add-ons
  </Card>

  <Card icon="percent" title="Volume Discount">
    Display tiered pricing for bulk purchases
  </Card>
</CardGroup>

## Managing App Blocks

### To Remove an App Block

1. Click on the app block in the theme editor
2. Select **Remove block** from the options
3. Save your changes

### Benefits of App Blocks

<AccordionGroup>
  <Accordion title="No code modifications">
    App blocks don't modify your theme's code, keeping it clean and maintainable
  </Accordion>

  <Accordion title="Easy management">
    Add, remove, or reposition blocks without touching any code
  </Accordion>

  <Accordion title="Automatic cleanup">
    Blocks are automatically removed when the app is uninstalled
  </Accordion>

  <Accordion title="Theme updates friendly">
    Your customizations are preserved when updating your theme
  </Accordion>
</AccordionGroup>

## Compatibility

<Warning>
  App blocks are only available for **Online Store 2.0** themes. If you're using a vintage theme, you'll need to use [alternative installation methods](/getting-started/installing-widgets).
</Warning>

## Need Help?

Having trouble setting up app blocks? Contact our support team at [support@assortion.com](mailto:support@assortion.com) for assistance.


# Set up checkout upsells
Source: https://docs.assortion.com/getting-started/setup-checkout-upsells

Boost your revenue with strategic checkout upsells

Checkout upsells allow you to present targeted offers to customers at the most critical moment - right before they complete their purchase. This feature can significantly increase your average order value.

## Setup Requirements

To use checkout upsells, you need to add the **Checkout Upsell** app block to your checkout page in the Shopify theme editor.

<Info>
  Checkout upsells require your store to have access to checkout extensibility features in Shopify.
</Info>

## Video Tutorial

Watch this step-by-step guide to setting up checkout upsells:

<Frame>
  <div>
    <iframe />
  </div>
</Frame>

## Quick Setup Steps

<Steps>
  <Step title="Access checkout editor">
    Navigate to your Shopify theme editor and select the checkout page
  </Step>

  <Step title="Add app block">
    Look for the **Checkout Upsell** app block in the apps section
  </Step>

  <Step title="Configure placement">
    Position the app block where you want upsells to appear during checkout
  </Step>

  <Step title="Create your offers">
    Set up your upsell offers in the Assortion dashboard
  </Step>
</Steps>

## Best Practices

<CardGroup>
  <Card icon="bullseye" title="Relevant Offers">
    Show products that complement what's already in the cart
  </Card>

  <Card icon="tag" title="Special Pricing">
    Offer exclusive checkout discounts to encourage immediate action
  </Card>

  <Card icon="clock" title="Limited Time">
    Create urgency with time-sensitive offers
  </Card>

  <Card icon="gift" title="Value Bundles">
    Package related items for better perceived value
  </Card>
</CardGroup>

## Creating Effective Upsells

### What Makes a Good Checkout Upsell?

* **Relevance**: Products that naturally complement the cart items
* **Value**: Clear benefit or discount for adding the item now
* **Simplicity**: Easy one-click addition to the order
* **Trust**: Don't overwhelm customers with too many options

### Examples of Successful Upsells

<Tabs>
  <Tab title="Accessories">
    If customer is buying a phone case, offer:

    * Screen protectors
    * Charging cables
    * Car mounts
  </Tab>

  <Tab title="Consumables">
    For consumable products, offer:

    * Bulk discounts
    * Subscription upgrades
    * Variety packs
  </Tab>

  <Tab title="Services">
    With physical products, consider:

    * Extended warranties
    * Installation services
    * Priority shipping
  </Tab>
</Tabs>

## Monitoring Performance

Track your checkout upsell performance in the Assortion dashboard:

* **Conversion rate**: Percentage of customers accepting upsells
* **Revenue impact**: Additional revenue generated
* **Popular offers**: Which upsells perform best
* **Customer behavior**: Acceptance patterns and trends

## Need Help?

For assistance with checkout upsells or if you're having trouble accessing checkout extensibility features, contact our support team at [support@assortion.com](mailto:support@assortion.com).


# Introduction
Source: https://docs.assortion.com/index

Everything you need to know about setting up and using Assortion

Welcome to the Assortion Help Center! Here you'll find comprehensive guides to help you set up and optimize your store with our powerful cart and checkout enhancement features.

## Popular Articles

<CardGroup>
  <Card title="Installing widgets to your store" icon="code" href="/getting-started/installing-widgets">
    Learn how to install Assortion widgets on your Shopify store
  </Card>

  <Card title="Setup app blocks for Online Store 2.0" icon="cubes" href="/getting-started/setup-app-blocks">
    Configure app blocks for modern Shopify themes
  </Card>

  <Card title="Integration with page builders" icon="puzzle-piece" href="/getting-started/integration-with-page-builders">
    Integrate Assortion with PageFly, GemPages, and other builders
  </Card>

  <Card title="Set up checkout upsells" icon="cart-plus" href="/getting-started/setup-checkout-upsells">
    Boost your revenue with checkout upsells
  </Card>
</CardGroup>

## Getting Started

New to Assortion? Start with these essential guides to get your store up and running with our powerful features.

<CardGroup>
  <Card title="Quick Start Guide" icon="rocket" href="/getting-started/installing-widgets">
    Get started with Assortion in minutes
  </Card>

  <Card title="Theme Integration" icon="palette" href="/getting-started/setup-app-blocks">
    Learn about theme compatibility and setup
  </Card>
</CardGroup>

## Need Help?

<CardGroup>
  <Card title="Contact Support" icon="message" href="mailto:support@assortion.com">
    Our support team is here to help
  </Card>

  <Card title="Join Our Community" icon="users" href="https://linkedin.com/company/assortion">
    Connect with other Assortion users
  </Card>
</CardGroup>