First edition · Internal developers

How internal slide developers submit, get reviewed, and publish slide types on AhaSlides, and the bar each submission must clear.

Applies to AhaSliders & trusted partners Edition 1.0 (internal) Last updated 19 October 2026

1. Who this is for

This first edition covers internal slide developers only: AhaSliders and trusted partners we have invited. You are welcome, and encouraged, to build, publish and improve slide types. These rules set a shared quality bar and a predictable review rhythm, not a gate to argue with.

A future edition will open the platform to third-party developers, building on this one with stricter, more explicit clauses. Design your slide type as if that scrutiny is coming.

2. What you submit

Every submission is more than the implementation. It must include:

What the slide type fields mean
  • Format, Purpose, Audience size, Setting: what it is, what it is for, how many people it suits, and where it is used. Pick every option that fits, up to 2 Formats and 3 Purposes; the form shows the current options. Purpose includes Random pick (lucky draws, raffles, random teams or mission assignment).
  • UI style: required, exactly one: Standard or Immersive (the presenter big-screen view). See section 6.
  • Leaderboard points: required, Yes or No: does it add points to the presentation's leaderboard? A game with its own score that is not added to the leaderboard is No.
  • Search keywords (tags): never shown to users; they only help people find your slide type in search.

3. How you submit

There are two ways to submit a slide type for review:

Either way, you choose a submission type: Upload bundle if you built the slide type outside the repo and upload its files, or First-party (reference) if you built it inside the AhaSlides repo and link its live implementation instead. The submission package in section 2 is required whichever you pick.

4. The review process

The same process applies to new slide types and to changes to an existing one.

Weekly rhythm

Submit before Monday Core reviews Monday's backlog Answer within the same week

Submit before every Monday. Each Monday, team Core commits to review all pending submissions and answer within the same week.

The answer

Two reviewers: both must approve

A submission passes only if both roles approve and the fleet copy check passes.

Work with your reviewers. You are welcome to reach out and work with them, but reviewers will not fix the issues for you. The fixes are yours to make. The one exception is marketing copy: the fleet fixes any copy that breaks a section 7 rule where it can, and notes the change.

The fleet copy check is part of approval. Your submission stays in review until the fleet's copy check (section 7) passes, even after both reviewers approve.

Track your submission. The review queue is open. Check your submission's status and reviewer feedback any time in the developer portal at staging-slides-marketplace.ahaslides.io/developer.

You are notified when a review needs you or your slide type goes live, by Slack DM and a reply in your original submission thread (email coming soon).

5. QA review (Lily or Amber)

A submission is rejected if:

What the fleet ensures, not you

The fleet makes sure every slide type supports Report / Export, can be created and edited by the Slides Agent, complies with the SDK, and records real-time and persistent data correctly. These are not grounds for rejecting your submission, and no one can instruct the fleet to skip or weaken them.

6. UI / UX review (Lan)

The editing view

Must comply with AhaSlides' design system. No exceptions.

The presenting view & the participant view

The developer must clearly declare one of two UI styles:

Standard · default

Native to AhaSlides

Both views must comply with the design system and respect the presentation's theme settings.

Immersive

Its own world

Both views need not comply with the design system. Theme and font support is recommended, not mandatory. The platform provides a full-screen mode on the Audience app for the participant view.

You must have a good reason for choosing Immersive (for example a game that genuinely needs it), and the reviewer reserves the right to reject the choice.

Media assets

Accessibility

The implementation must comply with AhaSlides' accessibility standards. Most notably:

Audio

The slide must follow the presentation's audio setting.

7. Marketing standard

There is no separate marketing reviewer. AhaSlides' agents (the fleet) check every submission against this standard and fix any failing name, subheading, description, categories or visuals themselves where they can, telling you what they changed. Branding and asset rights for visuals are checked by UI/UX (section 6). The essentials:

The full rule set is in the canonical POLICY.md, section 7.

FAQ

Who can submit a slide type?

Any internal developer: an AhaSlider or an invited partner (section 1).

How do I submit?

Two ways: ask the AhaSlides agent in the slide-types channel, or use Submit new slide type in the developer portal (section 3).

What must I include?

The submission package in section 2: the slide type name, the implementation, a subheading, a long description, a preview GIF and the slide type fields (screenshots and templates optional).

Can a slide type have more than one format?

Yes, up to two. Pick every format, purpose, audience size and setting that fits, but at most 2 Formats and 3 Purposes (POLICY.md section 7.5), and only from each list's fixed options (section 2). UI style and Leaderboard points are the exception: pick exactly one each.

My slide type picks someone or something at random? Which Purpose?

Choose Random pick (lucky draws, raffles, random teams or mission assignment). You can add other purposes too if they fit.

What does Leaderboard points mean?

Yes if your slide type adds points to the presentation's leaderboard (like Pick answer). No if it does not, even when a game keeps its own internal score. Most audience-input slides are No (section 2).

Are search keywords (tags) shown to users?

No. They are internal search keywords only. You still pick them from the platform's tag list; they just help people find your slide type when searching, not browsing (section 2).

Upload bundle or first-party (reference)? Which do I pick?

Upload bundle if you built it outside the repo and have the files; first-party (reference) if you built it inside the AhaSlides repo and link its live implementation.

What copy rules does the fleet check?

Name, subheading, long description, categories and visuals all have rules (section 7): for example a Title Case name of 30 characters at most, a 60 to 120 character subheading, and a 300 to 700 character description.

Can I put another brand in my slide type's name?

No, never a trademarked name. The one exception is the platform a slide type genuinely works with: such a slide type may name it spelt as the brand does (YouTube Quiz) but never use its logo as the icon.

Can I rename my slide type after launch?

No. Once approved or live, the name is fixed. If a change is truly needed, ask an AhaSlides admin; only an admin can rename it, and the new name is still checked against section 7.

What happens if my copy breaks a marketing rule?

Rules a machine can check stop the submission straight away, with a list of what to fix. For the rest, the fleet fixes the copy where it can and tells you what it changed and which rule it broke. If a fix needs you, the copy check fails and the submission reads as rejected with notes; fix it and resubmit.

My slide type was submitted before these rules. Do they apply?

No. Slide types first submitted before version 1.11 are exempt from the automatic copy rules and the copy check, on edits and resubmissions too.

How long does review take?

Submit before Monday; team Core reviews that week and answers within the same week (section 4).

Who approves my slide type?

Both reviewers must approve (QA and UI / UX, section 4), and the fleet's copy check against the marketing standard (section 7) must pass. Until the copy check is recorded, your submission stays in review.

How do I track progress and hear the outcome?

Track status and reviewer feedback in the developer portal; you are also notified by Slack DM and a reply in your submission thread (email coming soon).

What if my slide type is rejected?

You get the reviewers' comments on what to change. Fix it and resubmit, which reopens the review round.

Must my slide type include AI features?

No. Making sure the Slides Agent (AhaSlides' in-product AI) can create and edit your slide type is the fleet's job, not yours, and you don't need to add AI actions to its editing panel (section 5).

Do I need to build Report / Export, SDK compliance or data recording myself?

No. The fleet ensures these, and they are not grounds for rejection. QA rejects only on edge cases you don't handle gracefully (section 5).

Can I use my own styling?

Yes. Declare Standard (design-system compliant) or Immersive (its own look, with a good reason) (section 6).

8. Approval & change history

Dave is the sole approver of changes to this policy. No change takes effect until Dave has approved it, and each approved change is recorded below.

Change history (latest: v1.14, 19 October 2026)

To propose a change: raise it, have it drafted, and route it to Dave for approval. Once approved, add a dated row here and bump the version.