Skip to main content
All CollectionsOpportunitiesJob planner
Change the scheduler dates used in your opportunities iCal feed
Change the scheduler dates used in your opportunities iCal feed

Use the delivery, pickup, prep, in use, or other opportunity dates in your opportunities (Job Planner) iCal feed.

Matthew James Finkel avatar
Written by Matthew James Finkel
Updated over 5 years ago

The opportunities (Job Planner) iCal feed lets you see your opportunities on the calendar on your smartphone, computer, or other device.

By default, events on the iCal feed for opportunities will start and end based on the start and end date of the opportunity. For example, the event in my calendar app for the opportunity below starts July 10th and ends July 21st.

If you’d like to use other dates in the opportunity scheduler for your calendar events, like the delivery & collection dates or the prep & de-prep dates, you can add start_attribute and end_attribute parameters to your iCal feed link.

Keep in mind that you’ll need to use the extended scheduler to use the start_attribute and end_attribute parameters. 

Form the iCal feed

Go to the Job Planner by going to Opportunities > Job Planner. 

Click the link that says iCal calendar feed for your opportunities at the bottom of the screen.

The long links on this screen are your iCal feed links. There are four, one for each type of opportunity: orders, quotations, drafts, and inquiries. 

Copy the link you’d like to change and paste it somewhere safe, like a text editor.

  • add &start_attribute= immediately followed by one of the attributes below to set the date that should be used for the start of the event

  • add &end_attribute= immediately followed by one of the attributes below to set the date that should be used for the end of the event

Once you’ve formed your iCal feed link, copy the entire link and subscribe to it in your calendar app, or pass it onto a colleague to do this in their calendar. See: Get an iCal feed for opportunities (job planner)

⚠️   Keep your iCal feed link safe like a username and password. Only use it with trusted software and services.

Attributes

  • Prep start date
    ​prep_starts_at 

  • Prep end date
    ​prep_ends_at 

  • Load start date
    ​load_starts_at 

  • Load end date
    ​load_ends_at 

  • Delivery start date
    ​deliver_starts_at 

  • Delivery end date
    ​deliver_ends_at 

  • Setup start date
    ​setup_starts_at 

  • Setup end date
    ​setup_ends_at 

  • In use start date
    ​show_starts_at 

  • In use end date
    ​show_ends_at 

  • Takedown start date
    ​takedown_starts_at 

  • Takedown end date
    ​takedown_ends_at 

  • Pickup/collection start date
    ​collect_starts_at 

  • Pickup/collection end date
    ​collect_ends_at 

  • Unload start date
    ​unload_starts_at 

  • Unload end date
    ​unload_ends_at 

  • De-prep start date
    ​deprep_starts_at 

  • De-prep end date
    ​deprep_ends_at 

Examples

Here we’re using an example order iCal feed. If you wish to use these, replace the part of the URL before &start_attribute  with your own iCal feed from the Job Planner.

In use start date and in use end date

webcal://abcproductions.current-rms.com/opportunities/feed.ics?token=00000000-0000-0000-0000-04010f1a1c01&type=orders&start_attribute=show_starts_at&end_attribute=show_ends_at

Delivery start date and pickup/collection start date

webcal://abcproductions.current-rms.com/opportunities/feed.ics?token=00000000-0000-0000-0000-04010f1a1c01&type=orders&start_attribute=deliver_starts_at&end_attribute=collect_starts_at

Prep start date and de-prep end date

webcal://abcproductions.current-rms.com/opportunities/feed.ics?token=00000000-0000-0000-0000-04010f1a1c01&type=orders&start_attribute=prep_starts_at&end_attribute=deprep_ends_at

Blank dates

Where a date that you’ve used as an attribute in your iCal feed isn’t filled in, Current will use either the start or end date value. 

If the end_attribute is earlier than the start_attribute that you choose, Current will use the end date value.

Common questions

How do I subscribe to an iCal feed?

How to subscribe to an iCal feed varies depending on the calendar app or device you’re using. Here’s some links to common guides:

Need help?

Struggling to form your iCal feed link? Use the green help bubble at the bottom-right and we’ll be happy to help ↘️

Did this answer your question?