Setup and support
- Set up the widget
- Find your calendar's feed address
- When a calendar does not load
- How quickly changes appear
- Upgrade, cancel and billing
- Limits to know about
- Contact
1. Set up the widget
- Add the app to your site from the Wix App Market. The widget appears on your page showing sample events.
- Select the widget in the editor and open its Settings.
- Paste your calendar's feed address into Calendar feed (ICS/iCal) address. The next section explains where to find it.
- Press Test this feed. If the feed works, the settings say "This feed works" and show how many events were found. If not, they say why and what to do.
- Choose the opening view and adjust the colours, font and other options under Display and Design.
- Publish your site.
Inside the editor the widget may show sample events with the line "Sample events shown in the editor. Your calendar appears on the published site." That is expected: check your real calendar on the published site.
2. Find your calendar's feed address
The widget needs the calendar's feed address: a link that returns calendar data, usually called an ICS or iCal link. It is not the link you use to open the calendar in your browser.
A feed address:
- starts with
https://orwebcal://, - often ends in
.ics, - when opened in a new browser tab, downloads a file or shows text that starts with
BEGIN:VCALENDAR.
The calendar must be shared publicly, because the app reads it the same way any member of the public could. It cannot sign in to a calendar.
If your calendar is a Google Calendar
- Open Google Calendar on a computer and click the gear icon, then Settings.
- Under "Settings for my calendars", choose the calendar.
- In "Access permissions for events", tick Make available to public.
- Scroll to "Integrate calendar" and copy Public address in iCal format.
- Paste that address into the widget's settings and test it. Changes can take a few minutes to show.
If you paste the calendar's embed link, embed code or calendar ID instead, the settings convert it to the public iCal address for you. Do not use the "Secret address in iCal format": see the warning below.
Calendars from an email or office account
Most calendar services that come with an email or office account can publish a calendar. The option is normally in the calendar's settings under a name such as "Shared calendars", "Publish a calendar" or "Public calendar".
- Open the calendar's settings on the web (not in a phone app, which often lacks this option).
- Publish the calendar so that anyone with the link can view it. If you can choose how much is shown, pick the level you want visitors to see (for example all details, or only titles).
- You are usually offered two links: one to a web page (often labelled HTML) and one for calendar programs (labelled ICS or iCal). Copy the ICS link.
- Paste it into the widget's settings and test it.
If the calendar belongs to a work or school account and there is no option to publish it, your organisation's administrator may have switched public sharing off. Ask them, or use a separate calendar for public events.
Calendars on a phone, tablet or computer
Calendars that sync through a device maker's online account can usually be shared as a "Public Calendar" from the calendar's sharing options. This gives you a link that starts with webcal://. Copy it and paste it into the widget's settings as it is.
Tools for clubs, teams, schools and bookings
Many membership, sports, school and booking tools offer a link named "Subscribe", "Export", "iCal", "ICS" or "Sync to calendar". Use the link meant for calendar programs. If the tool only offers a link that includes a personal login key, treat it like a secret address (see below).
Everything in the feed is public
The complete feed, as your calendar service publishes it, is sent to each visitor's browser. Anyone can read it there with the browser's tools, including details the widget does not display: past events, notes, and the email addresses of organisers or attendees if your calendar service puts them in its public feed. Show only a calendar whose whole content may be public. If your calendar service lets you choose how much a public calendar reveals, choose that level with this in mind.
Do not use a secret or private address
The feed address you enter becomes part of your page's HTML, where any visitor can find it. Some services offer a "secret" address that opens a calendar which is otherwise private. Anyone who finds that address can read the whole calendar, so use the public address of a calendar you intend to be public. If you have already used a secret address, reset it in your calendar service.
3. When a calendar does not load
Open the widget's settings and press Test this feed under the calendar. If the answer is "This feed works", the feed itself is fine: see "The test works, but visitors see..." below. Otherwise the result is one of the following.
"The calendar is private, or the address is wrong"
The calendar's server refused the request. Either the calendar is not shared publicly, or part of the address is missing.
- Make the calendar public in your calendar service (section 2), then copy its ICS/iCal address again.
- Paste the whole address. Long addresses are easily cut off when copied.
- After making a calendar public, allow a few minutes before testing again.
"This address is not a calendar feed"
The address opened but returned a web page instead of calendar data. It is usually the link for viewing the calendar, or a sign-in page.
- Go back to your calendar's settings and copy the link labelled ICS or iCal, not the one labelled HTML or "view".
- Check by opening the address in a new browser tab: a feed downloads a file or shows text starting with
BEGIN:VCALENDAR.
"The calendar could not be reached"
The calendar's server did not answer in time, answered with an error, or its name could not be found.
- Check the address for typing mistakes.
- Open the address in a new browser tab. If it works there, test again in a few minutes: the calendar's server may have been briefly unavailable.
- The app waits up to 8 seconds for a calendar's server. A server that is regularly slower than that cannot be used.
"This address cannot be used"
For security the app only fetches public https:// addresses (a webcal:// address is read as https). It refuses:
- addresses starting with
http://, - addresses containing a user name, a password or a port number,
- addresses on a private or office network, including private numeric IP addresses,
- addresses that forward more than twice, or forward to any of the above.
A calendar on an internal server has to be published at a public https address before it can be shown.
"The calendar feed is too large"
Feeds larger than 1.5 MB are refused. Calendars with many years of history are the usual cause. Use a calendar with less history, or split it into smaller calendars.
"The test could not run"
The test never reached your calendar: the app's own server could not be reached, gave an unexpected answer, or refused the request.
- Check your internet connection and press Test this feed again after a moment.
- If the message stays, write to us (section 7) and include the whole message, with the text in brackets. That text tells us what the server answered.
The test works, but visitors see "The calendar could not be loaded."
- Make sure you published the site after changing the settings.
- Press "Try again" on the page, or reload it.
- Visitors are never told why a calendar failed; that detail is shown only in the settings.
- If it keeps happening, write to us (section 7).
Only my first calendar shows
The free plan shows one calendar: the first in your list. Showing several together is part of Pro. If you are on Pro and still see only the first calendar, reload the page; if it persists, the plan could not be confirmed at that moment and it should correct itself at the next page view.
The settings say "Your plan could not be checked"
The settings could not confirm your plan with Wix, so the free plan is assumed for now. Press Check again in that message. If the message stays, write to us and include the exact text shown.
The calendar became private, but visitors still see events
When your calendar service reports that a calendar is no longer public, visitors who saw it before keep the copy in their browser until it is 6 hours old, so that a short fault does not blank the page. After that the calendar disappears. (During an outage of the calendar's server, as opposed to a calendar made private, the last copy can stay about a day longer: see section 4.) To remove a calendar from your page at once, delete it from the widget's settings and publish. Copies already in visitors' browsers are then no longer shown, but they are not erased until the visitor clears the site's data, so treat anything that was once in a public feed as published.
4. How quickly changes appear
- A visitor's first page view shows your calendar at most about 5 minutes behind its feed.
- A visitor who comes back within about five minutes sees the copy kept in their browser, which can be about 10 minutes behind the feed.
- A visitor who comes back later is first shown the copy from their last visit (never one older than 7 days). It is replaced as soon as the current calendar has loaded, normally within seconds. If the app's server cannot be reached, the older copy stays on screen.
- A page left open checks again about every five minutes while its tab is visible.
- If your calendar's server is failing, the last good copy can be shown for up to about a day, and for some hours longer in the browser of a visitor who already had it.
The browser copy exists only where your site's consent settings permit functional storage; without it, every page view loads the calendar from the app's server.
On top of that, calendar services publish changes to their feeds with their own delay, which the app cannot shorten. With some services a new event takes minutes to reach the feed; with others it can take hours.
5. Upgrade, cancel and billing
The paid plan is sold and billed by Wix through your Wix account. We never see your payment details and cannot charge you ourselves. If you bought as a consumer in the EU or EEA, you have a 14-day right of withdrawal: see section 5 of the Terms.
Upgrade
- Open the widget's settings and go to Plan.
- Press Upgrade. Wix's checkout opens in a new tab and shows the price and billing period.
- Complete the purchase and return to the editor. The settings should show that you are on Pro, and the Pro options unlock.
- Publish your site.
Cancel
- Sign in to your Wix account and open the billing area (named "Billing & Payments" or "Subscriptions", depending on your account).
- Find the subscription for this app and turn off auto-renewal.
Pro stays active until the end of the period you have paid for. After that the widget returns to the free plan: it shows the first calendar in your list in month or agenda view (a widget set to the week view shows the agenda view), and the visitor links and fixed time zone are switched off. Your settings are kept, so upgrading again restores everything.
Wix does not let you delete an app from your site while its auto-renewal is on; cancel first.
Changing between monthly and yearly, refunds, invoices
To move to a cheaper billing period, cancel the current subscription and buy the other one when it ends. Invoices, payment methods, failed payments and refunds are handled by Wix: contact Wix's support for those. The exceptions are the 14-day right of withdrawal and the refunds promised in our Terms: for those, write to us. If something went wrong with the app itself, write to us as well.
6. Limits to know about
- Free: 1 calendar. Pro: up to 10 calendars per widget.
- Each feed can be up to 1.5 MB.
- Buttons in the calendar ("Today", "Month" and so on) are in English. Dates, weekdays and times follow the language you choose.
- The week view lists the events of each day; it is not an hour-by-hour grid.
- Where your site's consent settings permit functional storage, a visitor's browser keeps a copy of the calendar to load faster. On a site without a consent banner that is your site's default setting, not a choice the visitor made. Details are in the Privacy policy.
7. Contact
Write to apps@fastingpioneer.com. Support is by email, in English, for free and paid users alike.
To help us answer quickly, include:
- the address of the page on your site that shows the widget,
- the exact message shown after pressing "Test this feed", if there is one,
- which editor you use and, for display problems, the browser and device.
You do not need to send passwords or sign-in details, and we will never ask for them. Only send a feed address if the calendar is public.
For requests about personal data, see the Privacy policy.