Page tree
Skip to end of metadata
Go to start of metadata


Organize events and participants in Confluence.

Intuitive and structured.


Welcome to Linchpin Events!

This guide was created to help you with the setup of Linchpin Events. See what can be configured and how you can do it. 

For more information, make sure to view the Linchpin Events documentation.


Installation & licensing

Please refer to Atlassian's installation instructions: 

Installation via the Universal Plugin Manager


Step-by-step instructions

  1. Log in to your Confluence instance as an administrator.

  2. Open the Confluence general administration.
    1. Click on the Find new apps link in the sidebar.
  3. Enter "Linchpin Events" in the search field (marked by the text "Search the Marketplace"), then press Enter.
  4. Click on "Free trial" to test the app for 30 days, or click on "Buy now" if you want to purchase a license for Linchpin Events.
  5. You'll be prompted to register for or log into MyAtlassian.
  6. Linchpin Events will be automatically downloaded and installed after you log-in.

Set up event categories.

Users can label events with categories. Categories allow users to understand the event's purpose more quickly. They also make the navigation faster. Furthermore, event categories can be used as filters. You can, for example, personalize the event hub and other macros with help of event categories.


Navigate to Confluence administration > Linchpin Events > Event categories.

Enter the name of a category and click on the Save button to create a category.

Activate public image databases.

Linchpin Events uses either images uploaded by users or images from a royalty-free database like Unsplash.com. To make the integration of an online image database possible, you need to activate it.


Navigate to Confluence administration > Linchpin Events > Configuration > Event images.

Click on the slider next to "unsplash.com". A window with a disclaimer will open.

Read the disclaimer and activate both checkboxes. Then, click on the OK button.

The activation of the image database integration requires the agreement to the terms of use of the respective image database as well as access to the public internet on this Confluence instance.

This feature needs to be activated by the Confluence administration. It is an optional feature that is activated voluntarily.

//SEIBERT/MEDIA can't guarantee that every image uploaded to Unsplash.com is actually royalty-free. //SEIBERT/MEDIA can't and won't take any responsibility for possible copyright infringements made by the customer. If a third party tries to assert claims to compensate for damages to //SEIBERT/MEDIA, the customer is obligated to pay for any costs that result from those claims.

Make sure to read and understand the Unsplash.com terms of use before the activation of this function.

Make yourself familiar with various event categories.

You can display events in various ways. Take a first look at available macros.


Event macro



You can use the Event macro to display a single event on any Confluence page.

Set up event categories to filter within the Event macro. You can also filter by date, event title or even create a brand new event.

Select the event you wish to display and click on Insert.





Event Calendar macro



You can use the Event Calendar macro to display a monthly calendar with events.

Customize the macro by choosing which event categories should be displayed.


From these spaces only:

Leave empty to show all existing events. Input a space to show events only within this space.

Event categories:

Use categories as filters. Display only events of those categories (For example: Show only customer related events). Leave empty if you wish to display events of all categories.





Event List macro



You can use the Event List macro to display a compact list of events. It's a responsive macro, always adapting to available space.

Configure the macro to choose which events should be displayed. You can also limit the number of events that are being displayed at the same time.


Event space:

Leave empty to show all existing events. Input a space to show events only within this space.

Event categories:

Use categories as filters. Display only events of those categories (For example: Show only customer related events). Leave empty if you wish to display events of all categories.

Max. number of events to be shown:

You can limit the size of your event list. The default number of events being displayed is 15. Want a more compact list? Input the number of events that should be displayed.