Skip to main content
Profiles are the foundation of your presence on Aya. Each profile can represent an individual, organization, or product, with customizable pages, links, and visibility settings.

​
Profile Types

Individual

Personal profiles for individuals with a unique digital identity

Organization

Profiles for companies, nonprofits, and other organizations

Product

Dedicated profiles for products, projects, or services
Each user can have only ONE individual profile, but can create and manage multiple organization and product profiles.

​
Creating Your Profile

1

Sign up and authenticate

Create an account using GitHub, Apple, or other OAuth providers. Your individual profile is automatically created during signup.
2

Choose your slug

Select a unique slug (username) for your profile URL: aya.is/{locale}/{your-slug}
Slugs must be at least 2 characters and cannot use reserved words like admin, api, or login.
3

Customize your profile

Add your title, description, profile picture, and pronouns. All content supports 13 languages with automatic fallback.
4

Add pages and links

Create custom pages (like About, Projects, Resume) and add social/platform links with visibility controls.

​
Profile Customization

​
Basic Information

  • Title & Description: Multi-locale support with 3-tier fallback (requested locale → profile default → any available)
  • Profile Picture: Upload custom avatars or sync from connected accounts
  • Pronouns: Optional pronouns field for inclusive identity
  • Default Locale: Set your preferred language for content display

​
Custom Pages

Create unlimited custom pages for your profile with full Markdown support:
  • Public: Listed in sidebar, visible to everyone
  • Unlisted: Accessible via direct link, not listed in navigation
  • Private: Only visible to contributors and above
Each page includes:
  • Custom slug and title
  • Summary and full Markdown content
  • Optional cover image
  • Sort order for sidebar navigation
  • Multi-locale translations
Add social media, platforms, and custom links with advanced controls: Link Features:
  • Custom icons (emoji or initials)
  • Grouping for organization
  • Visibility levels (public → followers → sponsors → members → contributors → maintainers → leads → owners)
  • Featured links (highlighted on profile)
  • Verified badges (for OAuth-connected platforms)
  • Online status indicators (for live streams)
Supported Platforms:
  • GitHub (with OAuth integration)
  • YouTube (with live stream detection)
  • LinkedIn, X (Twitter), Telegram
  • Custom URLs for any platform

​
Membership System

Aya uses a hierarchical membership system with 7 levels of access.
Profiles support sophisticated membership relationships with role-based permissions:

​
Membership Levels

  1. Follower (Level 1) - Basic following relationship
  2. Sponsor (Level 2) - Financial or material support
  3. Member (Level 3) - Active community participation
  4. Contributor (Level 4) - Content creation and contributions
  5. Maintainer (Level 5) - Content moderation and management
  6. Lead (Level 6) - Strategic decisions and team leadership
  7. Owner (Level 7) - Full administrative control

​
Membership Referral System

Organizations and communities can enable referral-based membership:
1

Current member creates referral

Members with appropriate permissions refer a candidate profile
2

Community votes on referral

Existing members vote with scores (0-4) and optional comments during the voting period
3

Invitation sent if approved

When voting completes positively, the system sends an invitation to the candidate
4

Candidate accepts or rejects

The referred profile reviews and responds to the invitation
Referral Statuses:
  • voting - Active voting period
  • frozen - Voting paused by moderators
  • reference_rejected - Community voted against referral
  • invitation_pending_response - Awaiting candidate response
  • invitation_accepted - Member successfully added
  • invitation_rejected - Candidate declined

​
Profile Features & Modules

Profiles have toggleable features with three visibility states:
  • Public: Enabled and shown in navigation
  • Hidden: Enabled but not shown in navigation (direct access only)
  • Disabled: Completely disabled, returns 404
Available Modules:
  • Relations: Members, contributions, and team management
  • Links: Social media and platform connections
  • Q&A: Question and answer section for engagement
  • Discussions: Comment threads on profile pages

​
Teams & Organization

Organization and community profiles can create teams to organize members:
  • Group members by role, project, or department
  • Assign resources (repositories, links) to teams
  • Filter membership views by team
  • Track member and resource counts per team

​
Points System

Profiles accumulate points through various activities:
  • Creating and publishing content
  • Community engagement
  • Verified contributions
  • Special achievements
Points are displayed publicly on profiles and used for gamification features.

​
Search & Discovery

Global Search

Search across all profiles by title, description, and metadata

Spotlight Section

Featured profiles and resources appear in the homepage spotlight

​
Profile Permissions

The permission system controls who can view and edit profile content:
  • Admin users: Full access to all profiles
  • Profile owners: Complete control over their profiles
  • Contributors+: Can add/edit pages, links, and members based on membership level
  • Public users: View public content only
Use visibility settings on links and pages to create exclusive content for members, sponsors, or other specific membership tiers.

​
Multi-Locale Support

All profile content supports 13 languages: Supported Locales: ar, de, en, es, fr, it, ja, ko, nl, pt-PT, ru, tr, zh-CN Translation Workflow:
  • Set a default locale for your profile
  • Add translations for title, description, pages, and links
  • Automatic 3-tier fallback: requested locale → profile default → any available
  • AI-powered translation assistance (see AI Integrations)

​
Profile Ownership

Only the profile owner and admins can transfer ownership. This action cannot be undone.
Profile ownership can be transferred to other users with appropriate permissions. The new owner inherits:
  • Full administrative control
  • Ability to manage all content, members, and settings
  • Ownership transfer rights

​
Next Steps

Stories

Learn how to publish content to your profile

Custom Domains

Set up a custom domain for your profile

Organizations

Create organization profiles with teams

Communities

Build community profiles with membership controls

Build docs developers (and LLMs) love

Get started for freeTalk to us