Content Discovery & Search

Key Benefit: Provide powerful search and discovery capabilities that help users find relevant communities, content, and connections through intuitive interfaces and smart categorization.

Feature Overview

The Content Discovery & Search UIKit provides comprehensive components for building robust search and exploration experiences. From global search functionality to category-based browsing and notification management, these components enable users to discover and connect with the content and communities that matter to them.

Global Search

Universal Discovery

Cross-platform search functionality
Real-time search suggestions
Multi-content type results
Search history and suggestions

Community Discovery

Organized Exploration

Category-based browsing
Community recommendations
Search result filtering
My communities management

Advanced Search

Targeted Results

Community and user search
Search result customization
Filter and sort options
Result relevance ranking

Notifications

Stay Connected

Notification tray management
Real-time updates
Notification categorization
User engagement tracking

Implementation Guide

Comprehensive search across communities and usersThe Global Search Page offers robust and intuitive search functionality, allowing users to search for and discover communities and users that match their interests and needs.

Features

Feature	Description
Top Search Bar	Type search keyword and it will search across list of all communities and users
Community search result	Displays filtered communities, and clicks to open Community Profile Page
User search result	Displays filtered users, and clicks to open User Profile Page

Customization Options

Config ID	Type	Description
`social_global_search_page//`	Page	You can customize page theme

Code Examples

let socialGlobalSearchPage = AmitySocialGlobalSearchPage()
let viewController = AmitySwiftUIHostingController(rootView: socialGlobalSearchPage)

class CustomAmitySocialGlobalSearchPageBehavior: AmitySocialGlobalSearchPageBehavior {
    override init() {
        super.init()
    }
}

// Call this function to setup custom behaviour class in UIKit
func setSocialGlobalSearchPageBehaviour() {
    let customBehavior = CustomAmitySocialGlobalSearchPageBehavior()
    AmityUIKit4Manager.behaviour.socialGlobalSearchPageBehavior = customBehavior
}

Quick search component for any pageThe Top Search Bar provides seamless search functionality, located at the top of the page for easy access with advanced filtering capabilities.

Features

Feature	Description
Search	Type keyword to search and cancel searching

Customization Options

Config ID	Type	Description
`social_global_search_page/top_search_bar/*`	Component	You can customize component theme
`social_global_search_page/top_search_bar/search_icon`	Element	You can customize icon
`social_global_search_page/top_search_bar/clear_button`	Element	You can customize icon
`social_global_search_page/top_search_bar/cancel_button`	Element	You can customize text

Code Examples

let viewModel = AmityGlobalSearchViewModel()
let topSearchBarComponent = AmityTopSearchBarComponent(viewModel: viewModel)
let viewController = AmitySwiftUIHostingController(rootView: topSearchBarComponent)

Specialized search result displaysComponents for displaying filtered communities and users with clear layouts and interaction patterns.

Community Search Result Component

Displays a list of filtered communities that match search keywords.

Feature	Description
Communities list	A list of communities matching to search keyword

Customization Options

Config ID	Type	Description
`social_global_search_page/community_search_result/*`	Component	You can customize component theme
`social_global_search_page/community_search_result/community_private_badge`	Element	You can customize icon
`social_global_search_page/community_search_result/community_official_badge`	Element	You can customize icon

let viewModel = AmityGlobalSearchViewModel(searchType: .community)
let communitySerachResultComponent = AmityCommunitySearchResultComponent(viewModel: viewModel)
let viewController = AmitySwiftUIHostingController(rootView: communitySerachResultComponent)

User Search Result Component

Displays a list of filtered users that match search criteria.

Feature	Description
Users list	A list of users matching to search keyword

Customization Options

Config ID	Type	Description
`social_global_search_page/user_search_result/*`	Component	You can customize component theme

let viewModel = AmityGlobalSearchViewModel(searchType: .user)
let userSearchResultComponent = AmityUserSearchResultComponent(viewModel: viewModel)
let viewController = AmitySwiftUIHostingController(rootView: userSearchResultComponent)

When users click on search results, they are seamlessly navigated to the appropriate detail pages.

class CustomAmityCommunitySearchResultComponentBehavior: AmityCommunitySearchResultComponentBehavior {
    override init() {
        super.init()
    }
    
    override func goToCommunityProfilePage(context: AmityCommunitySearchResultComponentBehavior.Context) {
        // Custom implementation for navigatin to Community Profile Page
    }
}

// Call this function to setup custom behaviour class in UIKit
func setCommunitySearchResultComponentBehaviour() {
    let customBehavior = CustomAmityCommunitySearchResultComponentBehavior()
    AmityUIKit4Manager.behaviour.communitySearchResultComponentBehavior = customBehavior
}

Personal community managementSpecialized search functionality for users to find and manage their own communities with enhanced filtering options.

Features

Feature	Description
Search Bar	Type search keyword and it will search across list of all communities and users
Community search result	Displays filtered communities, and clicks to open Community Profile Page

Customization Options

Config ID	Type	Description
`my_communities_search_page//`	Page	You can customize page theme
`my_communities_search_page/*/community_private_badge`	Element	You can customize icon
`my_communities_search_page/*/community_official_badge`	Element	You can customize icon

Code Examples

let myCommunitySearchPage = AmityMyCommunitiesSearchPage()
let viewController = AmitySwiftUIHostingController(rootView: myCommunitySearchPage)

class CustomAmityMyCommunitiesSearchPageBehavior: AmityMyCommunitiesSearchPageBehavior {
    override init() {
        super.init()
    }
}

// Call this function to setup custom behaviour class in UIKit
func setMyCommunitiesSearchPageBehaviour() {
    let customBehavior = AmityMyCommunitiesSearchPageBehavior()
    AmityUIKit4Manager.behaviour.myCommunitiesSearchPageBehavior = customBehavior
}

Organized content explorationComponents for category-based community discovery and organized content browsing.

All Categories Page

Provides users with an organized list of community categories for easy exploration and discovery.

Feature	Description
Community Categories	Displays list of community categories with support for pagination

Customization Options

Config ID	Type	Description
`all_categories_page//`	Component	You can customize component theme

let page = AmityAllCategoriesPage()
let viewController = AmitySwiftUIHostingController(rootView: page)

Communities By Category Page

Offers a quick way to view all communities within a selected category for efficient exploration.

Feature	Description
List of communities	Displays list of communities under a particular categories with pagination support

Customization Options

Config ID	Type	Description
`communities_by_category_page//`	Component	You can customize component theme

let page = AmityCommunitiesByCategoryPage(categoryId: "<category-id>")
let viewController = AmitySwiftUIHostingController(rootView: page)

Centralized notification managementThe Notification Tray enhances user engagement by providing a comprehensive history of notifications with automatic grouping and organization.

Features

The Notification Tray automatically creates and groups notification records for each user, ensuring they stay informed about relevant activities within their communities and encouraging deeper platform engagement.

Code Examples

let page = AmityNotificationTrayPage()

Customization Options

Config ID	Type	Description
`notification_tray_page//`	Page	You can customize page theme
`notification_tray_page/*/back_button`	Element	You can customize image
`notification_tray_page/*/title`	Element	You can customize text
`notification_tray_page/*/empty_notification`	Element	You can customize image and text
`notification_tray_page/*/no_internet_connection`	Element	You can customize image and text

The behavior can be customized to handle navigation to post detail and community profile pages differently.

// Default Behavior
let behaviour = AmityNotificationTrayPageBehavior()

// Custom Implementation
class CustomBehaviour: AmityNotificationTrayPageBehavior {
    
    override func goToPostDetailPage(context: AmityNotificationTrayPageBehavior.Context) {
        // Custom implementation
    }
    
    override func goToCommunityProfilePage(context: AmityNotificationTrayPageBehavior.Context) {
        // Custom implementation
    }
}

// Usage
AmityUIKit4Manager.behaviour.notificationTrayPageBehavior = CustomBehaviour()

Component Management Strategies

Search Architecture

Designing comprehensive search experiencesPlan your search implementation by combining global search with specialized components like top search bars and category browsing. Consider user search patterns and how users move from general exploration to specific discovery.

Content Discovery Flow

Optimizing discovery pathwaysDesign clear pathways between different discovery methods (search, categories, recommendations). Ensure users can easily navigate between global search, category browsing, and their personal communities.

Notification Strategy

Managing user engagementImplement thoughtful notification policies that keep users engaged without overwhelming them. Use notification grouping and smart categorization to provide relevant information at the right time.

Implementation Strategy

Progressive Search Implementation

Building comprehensive search featuresStart with basic global search functionality, then add specialized search components for communities and users. Implement category-based discovery and notification management as your platform grows and user needs become more sophisticated.

User Experience Flow

Designing intuitive discovery pathsPlan search and discovery flows that guide users from general exploration to specific content discovery. Design clear navigation patterns between different search contexts and ensure smooth transitions between discovery and engagement.

Performance Considerations

Optimizing search experiencesImplement efficient search result caching, progressive loading for large result sets, and appropriate debouncing for real-time search suggestions. Consider indexing strategies and result relevance algorithms for optimal user experience.

Best Practices

Search UX Design

Creating effective search interfacesDesign clear search flows with intuitive filtering and sorting options. Provide helpful empty states, search suggestions, and clear result categorization. Ensure search interfaces are accessible and provide feedback for user actions.

Content Discovery Strategy

Facilitating content explorationBalance algorithmic recommendations with user-controlled discovery. Provide multiple pathways for content discovery (search, categories, recommendations) and help users understand why certain content is being suggested.

Notification Management

Respecting user attentionImplement thoughtful notification policies that respect user preferences and attention. Provide granular notification controls, smart batching for related notifications, and clear visual hierarchy for different notification types.

Social Feeds

Content Streams Social feeds and content discovery components

Communities

Community Features Community creation and management tools

Chat Components

Messaging Features Real-time chat and communication tools

Implementation Strategy: Begin with AmityGlobalSearchPage for comprehensive search functionality, then add specialized components like AmityTopSearchBar and category browsing based on your users’ discovery patterns and engagement metrics.

Powered by

Getting Started

Customization

Components

Release Notes

Support

​Feature Overview

Global Search

Community Discovery

Advanced Search

Notifications

​Implementation Guide

​Features

​Customization Options

​Code Examples

​Navigation Behavior

​Features

​Customization Options

​Code Examples

​Community Search Result Component

​Customization Options

​User Search Result Component

​Customization Options

​Navigation Behavior

​Features

​Customization Options

​Code Examples

​Navigation Behavior

​All Categories Page

​Customization Options

​Communities By Category Page

​Customization Options

​Features

​Code Examples

​Customization Options

​Navigation Behavior

​Component Management Strategies

​Implementation Strategy

​Best Practices

​Related Features

Social Feeds

Communities

Chat Components

Feature Overview

Implementation Guide

Features

Customization Options

Code Examples

Navigation Behavior

Features

Customization Options

Code Examples

Community Search Result Component

Customization Options

User Search Result Component

Customization Options

Navigation Behavior

Features

Customization Options

Code Examples

Navigation Behavior

All Categories Page

Customization Options

Communities By Category Page

Customization Options

Features

Code Examples

Customization Options

Navigation Behavior

Component Management Strategies

Implementation Strategy

Best Practices

Related Features