Welcome to the OpenCities help centre. Search for what you're after, or browse the categories.
Can't find what you're looking for? Submit a support ticket and we'll be in touch.


Create an OC Event page

avatar of OpenCities Product Team

OpenCities Product Team

Last updated

The OC Event content type is great for showcasing what's happening around your council or city.

Event pages include a number of useful fields, which allow you to easily present a snapshot of the event on your listings page and also give important details on the event page, including dates, times, locations, and supporting information.

See it in action: Check out the events listing page and event page on our demo site.

OC Event pages can be created anywhere in your site tree. However, to keep your site tree organized, we recommend creating them all under your listing page. Regardless of where you create your events, they will still be pulled into the listing page.

How to create an OC Event page

  1. Right-click in the site tree where you would like to create your event
  2. Select Create page
  3. Choose OC Event as the content type
  4. Select a template for your event from the Template Name dropdown menu
  5. Fill out the necessary fields
  6. Publish your page
  7. Set multiple locations and times, if you need to.
    Note: if you have created OC Event Location pages that need to be deleted, please ensure you republish the parent OC Event page so that it stays current.

OC Event pages have 2 templates to choose from, OC Default and OC With Full Width Image.

What to include on your OC Event page

Use the following information to fill out the OC Event page fields:

Field Function
Page name Completes the unique page URL
Event title The name displayed as the title of the page, in event listings and search results. The title has a limit of 70 characters
Add event summary A brief overview of the event for listing pages and search results. The summary has a limit of 400 characters
Add event dates Start time, end time, and dates of the event. You can also add multiple or recurring dates here. 
Select event categories

The categories associated with the event. These categories are also used as a search filter on the events listing page.

Note: Site Managers or System Administrators can customize the preset options available for event categories before content authors start creating content. Visit our Manage the Events module article for more details on how to do this.

Add event image

Main image for the event used on the listing page, search results, and the OC Event page.

Note: when choosing an image, make sure it is at least 900px wide. This size will work for both templates available. 

How much is the admission fee for this event? The ticket price for the event. Any information entered here will override the checkbox setting below.
Select checkbox if this event is free Choose the checkbox labelled 'Free' if the event is free of charge
Choose how this content will display on homepage listings

This dropdown menu will give you 3 options:

  1. Show on homepage listing (default): events will show as normal on the homepage listing, determined by the Add event dates field
  2. Pin to homepage listing: the event will be pinned to the homepage listing to show regardless of the event date
  3. Do not show on homepage listing: the event will not display on the homepage listing

Note: Past events will no longer show on the homepage listing, regardless of whether or not they are pinned.

Event location

Note: visit this article to learn how to set multiple locations for a single event

Additional information Any descriptions of the location (for example, on a specific corner, or a specific room and floor in a building)
Event venue Name of the event venue
Street address Street location of the event for Google maps
Locality Suburb of the event for Google maps
Postal code Post code or ZIP code of event for Google maps
Latitude Longitude (in decimal "lat, lon" format) 

The latitude and longitude to determine the event location on a map. You can add this yourself, or it will be automatically generated from the street address when the page is published.

We recommend manually entering the lat/long for events that don't have a fixed address. This will drop a map pin at the coordinates you specify.

Note: if you are adding this manually, please ensure the 'Overwrite lat/long values when the page is published' setting is set to 'No'. Access this setting from More > Site Management > your site > Settings > Location

Event host
Contact name Name of the contact person or organization 
Contact email Email of the contact person or organization
Contact phone number Phone number of the contact person or organization
Alternate phone number Alternate phone number of the contact person or organization
Event site or ticket site (starting with http:// or https://) Website URL for the event
Links to social media

Add links to social media pages for your event. If the domain of the URL you add has a matching icon in the default spritesheet, it will display with the link. This includes commonly used social icons, such as Facebook, LinkedIn, YouTube, Instagram, Google, etc.

If there is no matching icon, a default link icon will display instead.

Cancel event
Cancel this event? Check 'Yes' here to cancel the event
Additional information to show on event page (like reason for cancellation) Provide additional information about event cancellations
Supporting information
Additional side panels Add additional side panel content. Use the field provided to name the panel and the edit button to open the WYSIWYG Editor.
Add supporting images Event related images for an image gallery on the event page
Add supporting links Event related internal/external links
Add supporting documents Event related documentation
Add common search terms people would use when looking for this event Event keywords or metadata to boost page in search results
Content labels These labels organize your content internally (i.e. your site visitors won't see the labels). You can make content lists using these content labels.
Call to action link Add an additional call-to-action button link in the side panel (for example, a link to the event on an external site, or an add to calendar link)

If you want your community to be able to save this event to an external calendar, go to the Engagement tab and check the box to Show add to calendar on this page. If you can't see this setting, turn on the 'Add to calendar' function in the Events module settings. Go to Manage the Events module to learn how to do this.
'Add to calendar' checkbox in Engagement tab on OC Event page

Next steps:

Was this article helpful?
0 out of 0 found this helpful