> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supercycle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Sidekick

> Access your Supercycle circular commerce data through Shopify's AI assistant

Supercycle ships native [Shopify Sidekick](https://www.shopify.com/sidekick) extensions, so you can ask Sidekick about your cycles and act on them without leaving Shopify admin. Sidekick already lives inside admin where your team spends most of their time — it makes more sense for Supercycle to be a capable, well-integrated part of that experience than to ask you to context-switch into a separate chat.

## What you can do today

### Search your cycles data

Ask Sidekick questions in natural language and it will query Supercycle directly. The data extension exposes three read-only tools that cover the most common operational questions.

<AccordionGroup>
  <Accordion title="Cycles">
    Find cycles by customer, product, cycle number, or status. Fulfillment is the item going *out*; receival is the item coming *back*. Each has its own status (`due`, `scheduled`, `overdue`, `complete`).

    * *"What's overdue to come back?"*
    * *"Show me cycles shipping today."*
    * *"What cycles does Jane Doe have right now?"*
    * *"Look up cycle #1042."*
  </Accordion>

  <Accordion title="Customers">
    Find customers and see their email, membership/subscriber status, deposit balance, outstanding balance, and cycle counts (total and active).

    * *"How many active cycles does [jane@example.com](mailto:jane@example.com) have?"*
    * *"What's the outstanding balance for Jane Doe?"*
    * *"Which of my customers are subscribers?"*
  </Accordion>

  <Accordion title="Return orders">
    Find return orders by customer name, return number, or status (`requested`, `expected`, `received`, `in_progress`, `completed`, `cancelled`).

    * *"Any returns still expected this week?"*
    * *"Look up return #58."*
    * *"Show me returns in progress for Jane Doe."*
  </Accordion>
</AccordionGroup>

<Note>
  These tools are read-only. To change a cycle, Sidekick will direct you into the Supercycle app.
</Note>

### Include a product in your Supercycle catalog

Sidekick can take an existing Shopify product and set it up for cycles in Supercycle — the same "Include in Supercycle" flow exposed on the product index, now reachable conversationally.

* *"Add the Mountain Bike product to my Supercycle catalog."*
* *"Include this product in Supercycle."*
* *"Set up the Trail Tent for cycles."*

Sidekick opens Supercycle's product-import page with the product pre-loaded so you can confirm.

<Warning>
  Including a product **moves its inventory management from Shopify into Supercycle** and turns on *continue selling when out of stock* for it. Supercycle needs to manage inventory to track cycle availability. Confirm on the import page before the change is applied.
</Warning>

### Circular insights in Shopify Analytics

Sidekick can also surface circular-specific insights from your Shopify Analytics alongside the rest of your store data.

* *"How are my Supercycle products performing compared to standard sales?"*
* *"What's my circular revenue breakdown this month?"*

### Automations with Shopify Flow

Use Sidekick to build Shopify Flow automations that include Supercycle triggers and actions. Describe the workflow in natural language and Sidekick will help you build it.

* *"Create a flow that tags customers after their first completed cycle."*
* *"Notify me when a return is overdue by 3 days."*

## Vocabulary Sidekick understands

So Sidekick gives accurate answers, it's worth knowing the terms it maps between:

* A **cycle** is a single use of one item by one customer for a period of time. "Cycle", "rental", "booking", and "hire" are all treated as the same thing — we use **cycle** everywhere in the product.
* **Fulfillment** is the item going *out* to the customer; **receival** is it coming *back*. Overdue cycles are the most operationally urgent.
* A **return order** groups one or more cycles a customer is sending back.

You can refer to cycles and returns with or without the leading `#` (for example, `1042` or `#1042`).

## Why Sidekick

* **Where you already work** — Sidekick lives inside Shopify admin, no context-switching required.
* **Unified view** — Ask questions that span both your Shopify store data and your Supercycle circular operations.
* **Familiar interface** — Your team already knows how to use Sidekick, so there's nothing new to learn.

## What's next

We'll keep widening the surface area Sidekick can reach in Supercycle — more read tools, and more conversational actions that hand the merchant straight to the right page in the app to confirm a change.