This article is about the Proxi admin app at app.proxi.co.
Everything for getting your calendar in front of people lives behind one button. Open Calendar in the sidebar and click Share at the top of the page. It has two tabs: Links for ready-to-copy web addresses, and Embed for putting the calendar on your own website.
Share a Link to Your Calendar Page
Under Public calendar on the Links tab, you can shape the link before you copy it:
Group — leave it on All groups, or pick one so the link opens showing only that series. Good for sending "here's the concert series" without the rest of the calendar around it.
Opens On — choose List, Calendar or Map. Whoever you send it to lands on that view.
Show map view — leave it ticked to give visitors the Map tab, or untick it to hide the tab on this link.
Copy the address next to Calendar page.
Put it in your newsletter, your link in bio, a QR code on a poster — anywhere. The link always shows current events, so it never goes stale.
One more choice isn't a setting on this tab, but you can type it onto the link. Add ?featured=first to the end of the address to put your Featured events ahead of everything else, or ?featured=only to show nothing but Featured events. If the address already has a ? in it, join it on with & instead — for example …?group=abc123&featured=only. See Spotlight Your Featured Events below for what each one does.
Offer a Subscription
The iCal subscription address on the same tab is for people who want your events to appear inside the calendar app they already use, alongside everything else in their week. They paste it in once and it keeps updating on its own. It's a lovely thing to offer your board, your business owners, and the handful of people who come to everything.
Put the Calendar on Your Website
Open the Embed tab. You choose what the embed contains, then copy the code it builds for you:
Groups — tick the series you want included. Leave everything unticked to show all of them. Visitors can still filter between the ones you picked, but they'll never see anything outside your selection.
Venue — narrow to a single venue, if you have venues set up.
Featured events — leave it on Show all events, or pick Featured first or Featured only. More on these below.
Show these tabs — tick which views visitors get: List, Month, Map, Poster.
Adjust the layout options that appear (below), then click Copy embed code.
Paste the code into any page on your site that allows custom HTML.
It works on Wix, Squarespace, Webflow, WordPress, and anywhere else you can paste HTML. The embed picks up your workspace's colors automatically.
Which View It Opens On
The embed opens on the first tab you've ticked, reading down the list in the order shown: List, then Month, then Map, then Poster.
You can't drag them into a different order — so the way to change what opens first is to untick the ones above it.
An example: if you tick List and Poster, visitors land on List and can switch to Poster. If you want them to land on Poster instead, untick List.
Make a Poster Wall
To turn your events page into a wall of artwork, tick Poster and untick everything else. With only one tab ticked the view switcher disappears entirely, so visitors just get the posters — no tabs to click.
Two settings appear under Poster layout when Poster is on:
Columns — leave it empty for Auto and the wall fits itself to whatever space you give it, which is usually what you want. Set a number if you need a fixed count.
Rows at first — how many rows show before a Load more button appears. Two by default.
Worth doing first: give your upcoming events a Cover image, since that's the artwork the wall is made of. See The Four Calendar Views: List, Month, Map and Poster for how images are handled.
Spotlight Your Featured Events
Any event can be marked Featured — it's a switch in the event editor, and it adds a Featured tag on your calendar and makes the event's pin glow on the map.
The Featured events choice in the embed builder (or ?featured= on a link) lets that mark do more:
Featured first — everything still shows, but Featured events sort ahead of the rest. On a poster wall the featured posters fill the top of the grid; in List and Month views they lead their day. A quick heads up: a featured event three months out will sit ahead of tomorrow's events, since featured wins over date.
Featured only — nothing but Featured events, on every tab the embed shows. Clear the mark and the event drops off that embed; your other embeds and your public calendar page aren't affected.
This is the answer for a poster wall with only a handful of slots. Say your winter page pulls from a "Seasonal Highlights" group that also holds the ice rink's daily hours. Rather than moving the hours into another group, mark the rink's special events Featured and set the embed to Featured only — the hours stay in the group for your main calendar, and the poster shows just the events you want to spotlight. It combines with Groups and Venue, so "featured events in this group" works too.
If you're editing the code by hand, it's data-featured="first" or data-featured="only" on the <proxi-calendar> tag.
Keep an Embed Short
If you're putting the calendar in a narrow sidebar or a small section of a page, a full list can run long.
With List ticked, turn on Limit how many events show at first and enter a number — visitors see that many, then a Load more button for the rest. Ten is a good starting point for a sidebar.
Two Extras You Can Type Into the Code
A couple of options aren't in the embed builder, but you can add them by hand. In the code you pasted, the <proxi-calendar> tag already carries a few settings that start with data- — add either of these alongside them:
data-hide-load-more="1" — takes away the Load more button entirely. Pair it with a limit and the embed shows exactly that many events and stops there. Handy when you'd rather put your own "See all events" link under the calendar, pointing to a page on your site.
data-border-radius="0" — squares off the corners, for websites with a straight-edged look. Any number works: 0 is fully square, and bigger numbers round the corners more.
So a tag showing eight events, square-cornered, with no button, looks like: <proxi-calendar data-org-id="…" data-initial-list-count="8" data-hide-load-more="1" data-border-radius="0"></proxi-calendar>.
Let Visitors Add Their Own Events
Tick Show "Add Event" button and the embed carries a button to your submission form, so people can suggest events straight from your website. You'll still review everything before it goes live. This only appears as an option once at least one group accepts submissions.
The Links tab also has direct Submission forms addresses — one per group, plus an All groups link that lets people pick. Those are the ones to hand out at business meetings.
Good to Know
You can put several calendars on one page. Paste the <script> line once, then as many <proxi-calendar> blocks as you need — each with its own settings.
Different pages can carry different embeds from the same calendar: the concert series on your music page, the whole thing on your events page. You still only manage one calendar.
At least one tab has to stay ticked — an embed with no views can't show anything.
Changes you make to events show up in existing embeds on their own. You only need to re-copy the code if you change the embed's own settings.
Individual events have their own shareable links, in the event editor.
Running the whole calendar start to finish? See Step by Step: Running a Community Event Calendar.