Skip to main content
Stories are the content backbone of Aya. Create articles, announcements, events, and status updates that can be published to multiple profiles with full multi-locale support.

​
Story Types

Article

Long-form blog posts and in-depth content

News

News updates and press releases

Announcement

Important announcements and updates

Activity

Events, meetups, workshops, and conferences with RSVP

Status

Short status updates and thoughts

Content

General content and multimedia posts

​
Creating a Story

1

Choose story type

Select the appropriate type for your content. Activity stories have special event features like date proposals and RSVP.
2

Write your content

Use the rich Markdown editor to create your title, summary, and full content.
The summary appears in story lists and social shares - make it compelling!
3

Set publication details

Choose which profiles to publish to, set visibility (public/unlisted/private), and optionally enable discussions.
4

Configure slug

Set your URL slug in format YYYYMMDD-your-title where the date matches your publish date.
Slug format is enforced for published stories but flexible for drafts.
5

Publish or save as draft

Publish immediately or save as draft for later. Drafts can be edited freely.

​
Story URL Structure

Stories are accessible via slug-based URLs: 
https://aya.is/{locale}/{profile-slug}/stories/{story-slug}
Example: 
https://aya.is/en/acme-corp/stories/20250301-product-launch

​
Activity Stories (Events)

Activity stories have special features for organizing events:

​
Activity Types

  • Meetup: Casual gatherings and networking events
  • Workshop: Educational and hands-on sessions
  • Conference: Large multi-session events
  • Broadcast: Live streams and webinars
  • Meeting: Scheduled meetings and calls

​
Date Management

Set specific start and end times for your event. Times are stored and displayed in UTC.
{
  "date_mode": "fixed",
  "activity_time_start": "2025-03-15T14:00:00Z",
  "activity_time_end": "2025-03-15T16:00:00Z"
}
Let your community propose and vote on dates:
  1. Proposal Access: Control who can propose dates (anyone, follower, member, contributor, maintainer)
  2. Vote Access: Control who can vote on proposals
  3. Voting Period: Members submit and vote on proposed dates
  4. Final Selection: Organizers choose the winning date
Perfect for community events where scheduling flexibility is needed!

​
RSVP Management

RSVP Modes:

Disabled

No RSVP tracking

Managed Externally

Link to external registration (Eventbrite, Meetup.com, etc.)

Enabled

Built-in RSVP tracking on Aya
External Activity Links:
  • external_activity_uri: Link to the event (Zoom, venue map, etc.)
  • external_attendance_uri: Registration/ticketing platform

​
Multi-Profile Publishing

Publish a single story to multiple profiles:
1

Select publication profiles

Choose which profiles should display this story (must have contributor+ access)
2

Feature on specific profiles

Mark a story as “featured” on certain profiles to highlight it
3

Publication types

Set the publication kind (article, news, announcement, etc.) which can differ per profile
Stories can have different featured status on each profile, allowing flexible content curation.

​
Story Series

Group related stories into series:
  • Create a series for ongoing topics (e.g., “Product Updates 2025”)
  • Stories in a series can be ordered by sort_order
  • Series appear as collections on profile pages
  • Perfect for tutorials, release notes, or serialized content

​
Discussions on Stories

Enable discussions to allow comments on your stories:
1

Enable feat_discussions

Toggle discussions on/off per story or use profile default setting
2

Readers comment

Authenticated users can comment with full Markdown support
3

Moderation controls

Story authors and profile maintainers can pin, hide, or lock discussions
See Discussions for full comment system details.

​
AI-Powered Features

​
Auto-Summarization

AI summarization runs in batch mode overnight to generate concise summaries for stories without manual summaries.
The platform can automatically generate summaries using AI:
  • Summaries stored in summary_ai field
  • Batch processing for efficiency
  • Useful for long-form articles without hand-written summaries

​
Auto-Translation

Translate your stories to all 13 supported languages:
1

Select source locale

Choose the original language of your story
2

Select target locale

Pick the language you want to translate to
3

AI translation

The system translates title, summary, and content using configured AI provider
4

Points deducted

Auto-translation costs profile points (see Profiles for points system)
5

Review and edit

Review the AI-generated translation and make manual adjustments
Translation is a paid feature using profile points. Ensure you have sufficient points before translating.
See AI Integrations for provider configuration.

​
Visibility Settings

Public

Visible to everyone, appears in feeds

Unlisted

Accessible via direct link, not in feeds

Private

Only visible to contributors+ of publication profiles

​
Story Images

Add visual appeal with story pictures:
  • Upload custom images to https://objects.aya.is/
  • Images must use allowed URI prefixes (configured in service)
  • Displayed in story cards and headers
  • Supported in social media previews

​
Managed Stories

Stories marked as is_managed are synchronized from external sources (GitHub repos, RSS feeds, etc.) and cannot be edited directly through the UI.
Managed stories are automatically synchronized from external sources:
  • GitHub repository releases and updates
  • RSS feed imports
  • Other external content sources
  • Read-only in the UI to prevent sync conflicts

​
Editing & Deletion

Edit Permissions:
  • Story author (via their individual profile)
  • Profile owners where story is published
  • Admin users
Deletion Rules:
Stories with active publications cannot be deleted. Unpublish from all profiles first.

​
Story Interactions

Track engagement with story interactions:
  • View counts
  • Reaction counts
  • Comment counts (when discussions enabled)
  • Share tracking

​
Search & Discovery

Stories appear in:
  • Profile story feeds (filtered by kind)
  • Global search results
  • Story series collections
  • Featured story carousels
  • Bulletin board digests (see Bulletin Board)

​
Best Practices

  • Keep summaries under 160 characters for best social media preview
  • Include key points and value proposition
  • Use action-oriented language
  • Consider enabling AI summarization for consistency
  • Use YYYYMMDD prefix matching publish date
  • Keep URL-friendly (lowercase, hyphens, no special chars)
  • Include primary keyword for SEO
  • Minimum 12 characters total (9 for date + 3 for content)
  • Write in your primary language first
  • Use AI translation as starting point, then refine
  • Consider cultural context in translations
  • Test translations with native speakers when possible

​
Next Steps

Discussions

Enable comments and community engagement

Bulletin Board

Configure story digests for followers

AI Integrations

Set up translation and summarization

Profiles

Manage profile publishing settings

Build docs developers (and LLMs) love

Get started for freeTalk to us