IFComp Author’s Handbook

This document summarizes everything you need to know to as an IFComp entrant, from the basics of submitting an entry to expectations for feedback and followup after the competition ends.

Please feel free to direct any questions about the topics here to the competition organizers, or ask the community on the public forums.

How to enter the competition

Read the rules and guidelines

Please read through the rules at least once before you start preparing your entry. Familiarity with the rules with help you make sure your work will qualify for entry, and fill you in on conduct expected from entrants while the competition’s in play.

After that, the guidelines present some best-practice suggestions for authors, based on the collected community wisdom after many years of IF competitions. We strongly suggest you take the time to read this article, and think about how its advice might apply to your work.

Having more polished, high-quality entries improves the experience of the competition for everyone, and gives those works’ authors something to be proud of for a long, long time. (We did mention that the results pages go back to 1995, right?)

Submit the entry form

First, sign in to your user account at ifcomp.org, creating an account if you don’t already have one. (All accounts are free, private, and secure.)

Once you are signed in, visit the Register or manage your entries page (also available from the “Participate” menu in the website’s top navigation bar) and follow the prompts from there.

Note that availability of these options changes depending upon the current phase of the IFComp, according to its annual schedule.

Preview your entries

After you’ve submitted an entry or intent, please do make use of your entry preview page. It lets you see exactly what your entry will look like on the public ballot, including its cover art, blurb, and a set of working link-buttons.

It’s your responsibility to make sure that your entry looks and works how you intend it to, both on the ballot and in play. If you run into any problems or questions here, please contact us.

Comp communications

Don’t hesitate to write ifcomp@ifcomp.org with any questions, honest!

Please use a real, active email address

Your ifcomp.org login must be a valid email address that you intend to check regularly over the course of IFComp. (If it isn’t, you can use the website’s account-editing controls to change your account’s email address.)

If we have questions about your entry and you can’t answer because you gave us a burner address, we may have to disqualify your entry. This happens.

As always, we promise not to ever share or abuse your email. (The entry form lets you choose to share your email address with judges, but that’s an opt-in.)

You should get communications from ifcomp@ifcomp.org over the course of the comp, especially around the deadlines. If you don’t, something’s up: check your spam folder, and if you still don’t see anything from us, drop us a note at ifcomp@ifcomp.org.

When writing, identify your game

When writing the organizers about a particular entry, please mention your game’s name and its IFComp ID number, which you can find next to its name on your entry-management screen. (And if you can’t find that ID number, just tell us the game’s name.)

This really helps us! We have a lot of authors and entries every year. Telling us the name and ID number of your game every time you write in with questions saves us a lot of look-up work, and eliminates any possible confusion in follow-up conversation.

Warn us about unusually shaped entries

If you anticipate that your game may require extra effort on our end to manage or host – for example, if it contains tens of thousands of individual files – you should make us aware of that early, so that we can work out any potential issues together.

If we can’t get any such issues sorted by competition launch on September 1, we may ask to host the game yourself off-site – and if that presents further problems, you may have to withdraw your entry.

Important deadlines

IFcomp begins to accept entries every year on July 1. After that, the two big dates to know about are the intent deadline of August 1, and the final entry deadline of August 28. Your entry must meet both of these deadlines.

All deadlines expressed below are date-inclusive, and based in the Eastern time zone.

August 1: Deadline for intents

If you intend to have an entry in this year’s IFComp, then you must submit your intent via the entry form by 11:59 PM Eastern time on August 1. You can submit an intent without submitting a full entry – in fact, you can submit as little information as your game’s title, and the platform that it runs on (a Twine-built website, for example, or an Inform Z-code file).

This deadline exists to give the competition’s organizers time to plan. Knowing how many entries we can expect, and what kinds of games they’ll be, helps us a lot to prepare. Think of it as an RSVP.

Note that intents are not obligations. While we certainly hope that you will follow your submitted intent with a full entry, there’s no penalty if you don’t. (As we state in our guidelines, we would rather that you hold onto an unfinished game for a future competition than see you submit an incomplete work.)

August 28: Final entry deadline

You must submit your entry, in its entirety, by 11:59 PM Eastern time on August 28.

For the sake of fairness, the competition organizers enforce this deadline very strictly. We will not accept any entries submitted after that final minute has passed. Preparing the Comp for judging takes focused work by the organizers, and we really do need all the entries lined up by then. So, yeah — August 28 is a real, actual deadline.

Early submissions are welcome

As with all deadlines, on-time is good, but earlier is better. You can submit your entire entry as early as July 1, if it happens to be done that soon.

Updating your game

You can freely update your game until the final entry deadline, and then update it with some rules and restrictions during the judging period.

Update-availability schedule

Before August 28, you can update your game as much as you want, using the website’s entry form. You can re-upload your game’s files, change its cover art, rewrite its blurb, and even change its title. No need to ask; just go for it!

Between August 28 and September 1, updating is unavailable. The organizers need the entries “frozen” during this time, in order to prepare the competition for judging.

After September 1, the updating controls come back, with a caveat: you must provide a “changelog entry” with your update, summarizing the reasons for your update. (The form will prompt you for one.) Judges will be able to see these changelogs.

Updates and judges

IFComp makes two copies of each entry available: the entry as it stood the moment that the judging period began, and the most recent update made afterwards. Judges may choose to play and rate either one, depending upon their own preferences.

Note that the competition invites judges to rate whatever version of an entry they happen to play. If a judge plays and rates a version of an entry that gets replaced by a later update, they are under no obligation to replay or re-rate that new version.

Updates and the Archive

At the end of the competition, we will make both of these available to the IF Archive for permanent storage in its collection of IFComp entries.

(And, yes, if you don’t update your game after judging starts, then these two copies will be identical in all cases, and that’s just fine!)


IFComp offers two kinds of prizes: the Colossal Fund and a general Prize Pool.

The Colossal Fund

At the end of the year, the top two-thirds of so entries will earn a modest cash prize.

The money comes via PayPal. If you can’t do PayPal, we’ll write you a check from a bank based in the United States. But we really prefer PayPal.

We’ll contact you after the comp if you qualify for a Colossal Fund share. There’s a lot of post-comp stuff that happens, so you may not hear about it immediately, but we endeavor to get payments out by the end of the calendar year.

Prize pool

At the end of the comp, we begin reaching out to authors in the order of placement, asking them which prize they’d like to claim.

Physical prizes get postal-mailed from the donor to the claimant. Note that due to issues we have had over the years with posting physical prizes internationally, not all prizes may be available to all authors.

Being an author-and-donor

If you wish, you may certainly donate prizes and enter the competition during the same year, and we thank you in advance for your extra generosity! Please see the prize page for more details about donating.

Collecting feedback from judges

All IFComp entries can collect anonymous feedback from judges, and some also automatically collect anonymous play-transcripts as well.


We will reveal feedback collected about your game after the competition is all over, when the final results get posted. Feedback will be linked from your entry-management screen, and available to read and review for the remainder of the year.

All feedback is anonymous by default (though judges can identify themselves within feedback text if they choose to). As with all IFComp communication, feedback is subject to the IFComp code of conduct, so if you find yourself in receipt of feedback that crosses the line from critique into harassment, please let us know.


If your game is written with Inform, then its ifcomp.org-based online-play version might support transcripts, via Juhana Leinonen’s “if-recorder” software.

The website’s software will do its best to set up transcript-recording by itself, without requiring any additional work from you. If transcripts are available, they’ll appear on your entry-management screen once judging begins. We don’t guarantee that this will work — but it probably will.

Other services

As an IFComp author, you should understand the relationship between the competition and other online services in the IF community, particularly the IF Archive and the IFDB.

IF Archive

The IFComp organizers will upload all material you submit as part of your IFComp entry to the IF Archive for permanent, public storage and accessibility. We will upload an archive containing all of the entries as they stood when judging began on September 1, and also upload all individual comp games as they stood when judging closed on October 15.

If you release a post-comp edition of your game, and wish to add it to the IF Archive (which you should!), you’ll need to do that yourself, outside of the Archive’s competition directories. Contact the Archive staff if you need assistance with that.


Unlike with the IF Archive, IFComp does not take care of creating or updating records in The Interative Fiction Database about your IFComp entries. Some kind soul might put your game on IFDB, but there is no guarantee.

While we don’t require it, we do recommend that IFComp authors create or update IFDB pages about their own entries. (And yes, you are allowed to update your game’s IFDB page during the competition.)

If you do want to ensure that your game appears on IFDB appropriately, it’s a good idea to swing by a few days after the competition ends to ensure that the IFDB points to your game’s permanent location on the IF Archive. And, of course, if do any post-comp releases, you’ll also want to update your IFDB page to reflect that.

Good luck and have fun

And thank you for entering the Interactive Fiction Competition!