> For the complete documentation index, see [llms.txt](https://docs.productrentalspro.com/user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.productrentalspro.com/user-guide/integrations/calendar-feed.md).

# Calendar Feed

Pull your rentals into Google Calendar, Apple Calendar, Outlook, or other calendar systems

The calendar feed lets you see your Product Rentals Pro rentals in Google Calendar, Outlook, Apple Calendar, or any other app that can subscribe to an iCal (`.ics`) URL.

It is a **private, read-only** calendar feed for internal use. Rentals stay in Product Rentals Pro. Your calendar app only displays them. Changes you make in the calendar app are not sent back to Product Rentals Pro.

{% hint style="warning" %}
Calendar Feed is new and in beta. How it works may change without warning. If you run into a problem, [let us know](https://tally.so/r/mVlWGy).
{% endhint %}

Whilst the feed is live, your external calendar app controls how often it fetches the feed and refreshes it's calendar. Most calendar apps refresh every couple of hours, so don't assume that what is displayed in your calendar app is 100% live.

## Important: Security

**You should treat your calendar** `.ics` **URL like a password**, as it contains a unique token that authenticates and identifies your store with PRP.

**Don't** share this URL with marketplaces or other providers that only need to know whether a product is available for certain dates or not. The feed includes customer names and other rental details, not just busy dates.

Anyone who has the calendar URL can see:

* Rental IDs
* Customer names
* Rental items (products, variants and quantities)
* Rental status
* Delivery method
* City and province for shipping or local delivery
* Shopify order number (if applicable)

The feed **doesn't include** email addresses, phone numbers, street addresses, or rental notes. For privacy reasons, there are currently no plans to include these.

There is one calendar URL per store. Copy it only to the calendar apps that should see this information.

If the URL is leaked or accidentally sent to someone that shouldn't have this information, immediately [#regenerate-or-revoke-the-url](#regenerate-or-revoke-the-url "mention").

## Generate a calendar feed URL

A feed isn't automatically created for every store using PRP. You generate one only when you have a need to use it. To generate the URL:

1. In Product Rentals Pro, go to **Settings → Integrations → Calendar feed**.
2. Select **Generate calendar feed URL**.
3. Copy the secret feed URL.

You can return to this page later and copy the same URL again. Regenerating or revoking it is different - those actions stop the old URL from working. See [Regenerate or revoke the URL](#regenerate-or-revoke-the-url).

## Subscribe in your calendar app

Paste the URL as a **subscription**, not as a one-time import. Importing a file gives you a snapshot that will not update. Subscribing keeps the calendar in sync as rentals change.

Calendar apps refresh on their own schedule. Google and Outlook often take a few hours, and sometimes up to 24 hours, to show new or updated rentals. Apple Calendar on a Mac lets you choose how often to refresh.

### Google Calendar

Subscribe from a computer browser. You cannot add a calendar from a URL in the Google Calendar mobile app.

1. Open [Google Calendar](https://calendar.google.com) on a computer.
2. On the left, next to **Other calendars**, select the **+** and choose **From URL**. You can also use **Settings → Add calendar → From URL**.
3. Paste the Product Rentals Pro calendar URL.
4. Select **Add calendar**.

The feed appears under **Other calendars** with the name **Rentals**.

### Outlook

Use Outlook on the web so the subscription also shows in the Outlook desktop and mobile apps.

1. Sign in to Outlook on the web and open **Calendar**.
2. Select **Add calendar**.
3. Select **Subscribe from web**.
4. Paste the Product Rentals Pro calendar URL.
5. Select **Import**.

Do not use **Upload from file**. That imports a one-time copy and will not stay up to date.

### Apple Calendar

**On a Mac**

1. Open the Calendar app.
2. Choose **File → New Calendar Subscription**.
3. Paste the Product Rentals Pro calendar URL and select **Subscribe**.
4. Name the calendar and choose a color.
5. For **Location**, choose **iCloud** if you want it on your iPhone and iPad as well, or **On My Mac** to keep it on that computer.
6. Set **Auto-refresh** if you want more frequent updates, then select **OK**.

**On iPhone or iPad**

You can also add the subscription on the device:

1. Open **Settings**.
2. Go to **Apps → Calendar → Calendar Accounts** (on older iOS: **Settings → Calendar → Accounts**).
3. Select **Add Account → Other → Add Subscribed Calendar**.
4. Paste the URL, then save.

On recent iOS versions you can also open Calendar, tap **Calendars**, then **Add Calendar → Add Subscription Calendar**.

Choose **iCloud** as the account if you want the same subscription on all of your Apple devices.

## What each event shows

Each rental is one calendar event, from a start date to an end date, and for the full days (no times of day).

**Event Title** looks like:

`Rental #1042 — Jane Smith — Party Tent 6x6, Folding Chairs x20`

**Event Details** include:

<table><thead><tr><th width="154">Field</th><th>What you see</th></tr></thead><tbody><tr><td>Status</td><td>Reserved, Confirmed, Packed, Dispatched, Returned, or Cancelled</td></tr><tr><td>Delivery</td><td>Pickup, Shipping, or Local delivery</td></tr><tr><td>Order</td><td>Shopify order number, when the rental has one</td></tr><tr><td>Items</td><td>Product, variant, and quantity</td></tr><tr><td>Location</td><td>Pickup, or the city and province for shipping and local delivery</td></tr></tbody></table>

When [include buffers](#include-buffers) is on, the event details also list the rental’s original start and end dates (without buffers), formatted with your store’s date format.

### How rental status appears in the calendar

<table><thead><tr><th width="231">Rental status</th><th>Included in .ics feed?</th><th>Calendar event</th></tr></thead><tbody><tr><td>Reserved</td><td>Yes</td><td>Marked as tentative</td></tr><tr><td>Confirmed, Packed, Dispatched, or Returned</td><td>Yes</td><td>Marked as confirmed</td></tr><tr><td>Cancelled</td><td>Only if rental was updated recently (last 30 days)</td><td>Marked as cancelled so the calendar can remove it</td></tr></tbody></table>

## Include buffers

On the Calendar feed page, **Include buffers** controls which dates each event covers.

* **Off (default):** events use each rental’s start and end dates.
* **On:** those dates are extended by the rental’s start and end buffer durations

Turning this setting on or off **doesn't** change the calendar URL. Your calendar app will pick up the new dates the next time it refreshes.

## Which rentals are included

The feed includes rentals that overlap this window:

* 30 days in the past
* 18 months in the future

Cancelled rentals appear only if they were cancelled recently (within that 30-day lookback). That gives calendar apps a chance to drop them. Older cancelled rentals are left out.

Blackout dates aren't included.

**The feed is capped at 250 rental events.** It's intended for use by smaller businesses who may not operate in the Shopify admin on a daily basis. We don't at this point have evidence of a sync to a personal calendar app being useful to a businesses with a higher rental volume than this. Larger integrations should use the [Developer API](https://docs.productrentalspro.com/user-guide/integrations/developer-api.md).

## Regenerate or revoke the URL

### Regenerate

Use **Regenerate** if the URL may have been shared with the wrong person, or you want a fresh URL.

The current URL stops working immediately. Any calendar that already subscribes to it will stop updating. Copy the new URL and update each calendar subscription.

### Revoke

Use **Revoke** to turn the feed off.

The URL stops working and the feed is removed until you generate a new one.

## What the calendar feed doesn't do

* It doesn't import events from your calendar into Product Rentals Pro.
* It doesn't include blackout dates.
* It doesn't let you edit rentals from the calendar app.
* It doesn't let you view contact or personally identifiable information about a customer, outside of their name.
* Changes in the calendar app never write back to Product Rentals Pro.

## Feedback

Calendar feed is in beta. If something looks wrong, [send us feedback](https://tally.so/r/mVlWGy).
