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

# Rental Troubleshooting

> Fixes for common rental setup and storefront issues.

## The rental calendar doesn't appear on my product page

If customers can't see the date picker on a rental product, work through these checks in order:

<AccordionGroup>
  <Accordion title="Is the product set up as a rental?" defaultOpen>
    A product only shows the calendar once it's been added as a rental. Go to **Shopify Admin** → **Circuly Rental & Subscriptions** → **Rentals** → **Inventory** → **Add a rental product** and add this product.
  </Accordion>

  <Accordion title="Does the product have a pricing template assigned?">
    The calendar needs a pricing template to calculate prices. Open the rental product and confirm a pricing template is assigned. If you don't have one yet, create it under **Rentals** → **Pricing**.
  </Accordion>

  <Accordion title="Is the rental calendar block added to your theme?">
    The calendar is added to your product page through the Shopify Theme Editor. Confirm the **rental calendar block** is placed on the product template assigned to this product. See [Theme Extension Setup](/docs/mintlify/theme-extension) for instructions.
  </Accordion>
</AccordionGroup>

## "Couldn't set up this product" when adding a rental product

If you see this error while adding a rental product, the variant's stock settings are blocking it:

<AccordionGroup>
  <Accordion title="The variant is set to stop selling when out of stock" defaultOpen>
    This happens when the product variant has Shopify inventory tracking turned on with **Stop selling when out of stock**. The Rental Engine manages availability through its own calendar, so this setting conflicts with rental setup.

    To fix it, open the product in Shopify and either turn off **Track quantity** for that variant, or change it to **Continue selling when out of stock**. Then try adding the rental product again. See [Rental inventory model](/docs/mintlify/rental-inventory-model) for more on how rental stock works.
  </Accordion>
</AccordionGroup>

## No public holidays are blocked for my country

If your rental calendar lets customers book on national holidays:

<AccordionGroup>
  <Accordion title="Your country isn't pre-seeded" defaultOpen>
    Public holidays are only pre-loaded for a set of countries: the Netherlands, Germany, Spain, the United Kingdom, and the United States. Other countries start with no holidays blocked.

    To block holidays for your country, add them as manual blackout dates under **Rentals** → **Blackouts**. See [Blackouts and holidays](/docs/mintlify/rental-blackouts-and-holidays).
  </Accordion>
</AccordionGroup>

## A customer was charged and then automatically refunded

If a customer reports a charge that was reversed shortly after:

<AccordionGroup>
  <Accordion title="A rare booking conflict was auto-resolved" defaultOpen>
    In rare cases, two customers secure the same units for overlapping dates at almost the same moment. When that happens, the system honours the first booking and automatically refunds the line it can't fulfil, so the second customer is never left paying for a rental they can't receive.

    No action is needed — the refund is issued automatically. See [Cancellations and refunds](/docs/mintlify/rental-cancellations-refunds) for details.
  </Accordion>
</AccordionGroup>

## I can't create a rental product — no pricing template available

If the rental product setup won't let you continue because there's no pricing template to choose:

<AccordionGroup>
  <Accordion title="Create a pricing template first" defaultOpen>
    Every rental product needs a pricing template before it can be set up. Create one under **Rentals** → **Pricing**, then return to add your rental product. See [Pricing templates](/docs/mintlify/rental-pricing-templates).
  </Accordion>
</AccordionGroup>

## A booking is holding stock but the customer never paid

If units appear reserved even though no rental was paid for:

<AccordionGroup>
  <Accordion title="Held cart bookings expire on their own" defaultOpen>
    When a customer adds rental dates to their cart, the units are held as a **booking** while they check out. If they don't pay, that held booking expires after the cart timeout (30 minutes by default) and the units are released automatically.
  </Accordion>

  <Accordion title="Admin-created bookings must be cancelled manually">
    Bookings you create yourself from the admin don't expire automatically. If one is no longer needed, cancel it manually to release the units. See [Booking flow](/docs/mintlify/rental-booking-flow).
  </Accordion>
</AccordionGroup>

## Still need help?

If you can't resolve your issue with the steps above, contact our support team:

<Card title="Contact Support" icon="envelope" href="mailto:miguel@circuly.io">
  Email us at [miguel@circuly.io](mailto:miguel@circuly.io) and include your store URL, a description of the issue, and any relevant screenshots.
</Card>