Event

UIKit Component: Event components are built on top of the social.plus SDK, providing ready-to-use event creation and discovery UI with full data management handled automatically.

Feature Overview

The Event feature in social.plus UIKit v4 enables users to create scheduled events, discover upcoming/past events, manage attendees, and navigate between event-related experiences.

Key Features

Event Creation

Schedule events with rich details

Select where to create the event
Configure details (name, description, date & time)
In-person or virtual options

Event Discovery

Explore and manage your events

Explore events feed
Upcoming events page
Past events page
Community-specific event feed

Attendees & RSVP

Track and manage attendance

RSVP (Going/Not going)
Attendees list
Reminder Notifications

Platform Support

Feature	iOS	Android	Web	Flutter	React Native
Event Creation	✅	✅	✅	-	-
Event Detail & Attendees	✅	✅	✅	-	-
Event discovery	✅	✅	✅	-	-
Event in community profile	✅	✅	✅	-	-

Permission Handling

Spec 6 defines the visibility rules for entry points that trigger event creation:

Global feed: Only users with global permission will see the create event button
- Check: client.hasPermission(AmityPermission.createEvent)
Community feed: Users with global OR community permission will see the create event button
- Check: client.hasPermission(AmityPermission.createEvent, communityId)

UIKit applies these permission checks automatically. If you implement your own custom entry points, keep the same permission logic for consistent UX.

Implementation Guide

Event Creation
Event Details
Event Discovery

Event Target Selection Page

Use AmityEventTargetSelectionPage to choose the destination for the event (Note: community only).

Customization Options

Config ID	Type	Description
`select_event_target_page//`	Page	Customize page theme
`select_event_target_page/*/close_button`	Element	Customize close button image
`select_event_target_page/*/title`	Element	Customize page title

Code Examples

let page = AmityEventTargetSelectionPage()
let viewController = AmitySwiftUIHostingController(rootView: page)
navigationController?.pushViewController(viewController, animated: true)

Event Setup Page

Use AmityEventSetupPage to create or edit an event.

Public API:

enum AmityEventSetupPageMode {
  case create(targetId, targetName)
  case edit(AmityEvent)
}

AmityEventSetupPage(mode: AmityEventSetupPageMode)

Customization Options

Config ID	Type	Description
`event_setup_page//`	Page	Customize page theme
`event_setup_page/*/title`	Element	Customize title
`event_setup_page/*/camera_button`	Element	Customize camera label/icon
`event_setup_page/*/image_button`	Element	Customize photo label/icon
`event_setup_page/*/event_name_title`	Element	Customize “Event name” label
`event_setup_page/*/event_details_title`	Element	Customize “Event details” label
`event_setup_page/*/event_date_time_title`	Element	Customize “Date and time” label
`event_setup_page/*/event_location_title`	Element	Customize “Location” label

Code Examples

// Create
let page = AmityEventSetupPage(mode: .create("<targetId>", "<targetName>"))
let viewController = AmitySwiftUIHostingController(rootView: page)
navigationController?.pushViewController(viewController, animated: true)

// Edit
// When you already have an AmityEvent object
let editPage = AmityEventSetupPage(mode: .edit(event))

Event Detail Page

Use AmityEventDetailPage to view event details and access event actions.

Public API:

AmityEventDetailPage(eventId: string)

Code Examples

let page = AmityEventDetailPage(eventId: "<eventId>")
let viewController = AmitySwiftUIHostingController(rootView: page)
navigationController?.pushViewController(viewController, animated: true)

Event Attendees Page

Use AmityEventAttendeesPage to browse attendees and navigate to a user profile.Public API:

AmityEventAttendeesPage(eventId: string)

Code Examples

let page = AmityEventAttendeesPage(eventId: "<eventId>")
let viewController = AmitySwiftUIHostingController(rootView: page)
navigationController?.pushViewController(viewController, animated: true)

Upcoming & Past Events Pages

Use AmityUpcomingEventsPage and AmityPastEventsPage to browse events by time.

Customization Options

Config ID	Type	Description
`upcoming_events_page//`	Page	Customize upcoming events page
`past_events_page//`	Page	Customize past events page

Feed Components

Event discovery surfaces embedded in existing feature pagesSpec 6 aligns the Event feature with these components:

AmityExploreEventFeedComponent
AmityMyEventFeedComponent
AmityCommunityEventFeedComponent
AmityEventInfoComponent
AmityEventDiscussionFeedComponent

These components are typically used inside existing UIKit pages (e.g., Social Home and Community Profile). If you’re using the standard Social Home experience, you get these feeds automatically.

Customization Options

Config ID	Type	Description
`social_home_page/my_event_feed_component/*`	Component	Customize My Event feed section
`social_home_page/explore_event_feed_component/*`	Component	Customize Explore Event feed section
`community_profile_page/*/create_event_button`	Element	Customize create event button label
`social_home_page/create_post_menu/create_event_button`	Element	Customize create-event entry in create-post menu

If you need to hook navigation (e.g., “View all upcoming”), use the corresponding Behavior class documented in the next tab.

Customization

UIKit provides these customization keys for event entry points and pages.

{
  "*/community_sidebar/communities_sidebar_menu_item": {
    "text": "Communities",
    "icon": ""
  },
  "*/community_sidebar/events_sidebar_menu_item": {
    "text": "Events",
    "icon": ""
  },

  "social_home_page/*/communities_button": {
    "text": "Communities"
  },
  "social_home_page/*/events_button": {
    "text": "Events"
  },
  "social_home_page/create_post_menu/create_event_button": {
    "text": "Event",
    "image": ""
  },
  "social_home_page/my_event_feed_component/*": {},
  "social_home_page/explore_event_feed_component/*": {},

  "community_profile_page/*/create_event_button": {
    "text": "Event"
  },

  "select_event_target_page/*/*": {},
  "select_event_target_page/*/close_button": {
    "image": ""
  },
  "select_event_target_page/*/title": {
    "text": "Create event in"
  },

  "event_setup_page/*/*": {},
  "event_setup_page/*/title": {
    "text": "Create event"
  },
  "event_setup_page/*/camera_button": {
    "text": "Camera",
    "image": ""
  },
  "event_setup_page/*/image_button": {
    "text": "Photo",
    "image": ""
  },
  "event_setup_page/*/event_name_title": {
    "text": "Event name"
  },
  "event_setup_page/*/event_details_title": {
    "text": "Event details"
  },
  "event_setup_page/*/event_date_time_title": {
    "text": "Date and time"
  },
  "event_setup_page/*/event_location_title": {
    "text": "Location"
  },

  "upcoming_events_page/*/*": {},

  "past_events_page/*/*": {}
}

Behavior Customization

UIKit provides behavior classes to customize navigation and actions for event-related pages and components.

Page Behaviors

class AmityEventTargetSelectionPageBehavior {

    goToEventSetupPage(context): void {
      // navigation logic
    }

}

class AmityEventSetupPageBehavior {

    goToEventDetailPage(context): void {
      // navigation logic
    }

}

class AmityEventDetailPageBehavior {

    goToEventSetupPage(context): void {
      // navigation logic
    }

    goToLivestreamPostComposerPage(context): void {
      // navigation logic
    }

    goToPostDetailPage(context): void {
      // navigation logic
    }

    goToPostComposerPage(context): void {
      // navigation logic
    }

    goToPollPostComposerPage(context): void {
      // navigation logic
    }

    goToCommunityProfilePage(context): void {
      // navigation logic
    }

    goToEventAttendeesPage(context): void {
      // navigation logic
    }

}

class AmityEventAttendeesPageBehavior {

    goToUserProfilePage(context): void {
      // navigation logic
    }

}

class AmityNotificationTrayPageBehavior {

    // ... existing behaviors

    goToEventDetailPage(context): void {
      // navigation logic
    }

}

class AmityCommunityProfilePageBehavior {

    // ... existing behaviors

    goToEventDetailPage(context): void {
      // navigation logic
    }

}

Component Behaviors

Explore Event Feed
My Event Feed
Create Post Menu
My Communities

class AmityExploreEventFeedComponentBehavior {

    goToUpcomingEventsPage(context): void {
      // navigation logic
    }

}

class AmityMyEventFeedComponentBehavior {

    goToUpcomingEventsPage(context): void {
      // navigation logic
    }

    goToPastEventsPage(context): void {
      // navigation logic
    }

}

class AmityMyCommunitiesComponentBehavior {

    // ... existing behaviors

    goToCommunitySetupPage(): void {
      // navigation logic
    }

}

Events SDK

SDK event APIs and data models

Community

Community UI components

Livestream

Livestream UI components

Powered by

Getting Started

Customization

Components

Release Notes

Support

Feature Overview

Key Features

Event Creation

Event Discovery

Attendees & RSVP

Platform Support

Permission Handling

Implementation Guide

Event Target Selection Page

Customization Options

Code Examples

Event Setup Page

Customization Options

Code Examples

Event Detail Page

Code Examples

Event Attendees Page

Code Examples

Upcoming & Past Events Pages

Customization Options

Feed Components

Customization Options

Customization

Behavior Customization

Page Behaviors

Component Behaviors

Events SDK

Community

Livestream

Powered by

Getting Started

Customization

Components

Release Notes

Support

​Feature Overview

​Key Features

Event Creation

Event Discovery

Attendees & RSVP

​Platform Support

​Permission Handling

​Implementation Guide

​Event Target Selection Page

​Customization Options

​Code Examples

​Event Setup Page

​Customization Options

​Code Examples

​Event Detail Page

​Code Examples

​Event Attendees Page

​Code Examples

​Upcoming & Past Events Pages

​Customization Options

​Feed Components

​Customization Options

​Customization

​Behavior Customization

​Page Behaviors

​Component Behaviors

​Related Topics

Events SDK

Community

Livestream

Feature Overview

Key Features

Platform Support

Permission Handling

Implementation Guide

Event Target Selection Page

Customization Options

Code Examples

Event Setup Page

Customization Options

Code Examples

Event Detail Page

Code Examples

Event Attendees Page

Code Examples

Upcoming & Past Events Pages

Customization Options

Feed Components

Customization Options

Customization

Behavior Customization

Page Behaviors

Component Behaviors

Related Topics