# Introductions to Invitations

See also:

* [Technical Reference for Invitations](https://docs.openreview.net/reference/api-v2/entities/invitation)
* How to Guides:
  * [Change Submission Expiration Date](https://docs.openreview.net/how-to-guides/workflow/how-to-change-the-expiration-date-of-the-submission-invitation)
  * [Change Submission Readers](https://docs.openreview.net/how-to-guides/workflow/how-to-change-who-can-access-submissions-after-the-deadline)
  * [Hide Submission Fields](https://docs.openreview.net/how-to-guides/workflow/how-to-hide-submission-fields-from-reviewers)
  * [Customizing Forms](https://docs.openreview.net/getting-started/customizing-forms)

In OpenReview, **invitations** define the rules and permissions for creating or editing entities such as [notes](https://docs.openreview.net/getting-started/objects-in-openreview/introduction-to-notes), [groups](https://docs.openreview.net/getting-started/objects-in-openreview/groups), and edges. They act as **templates** that control who can perform specific actions, what content is expected, and how submissions are processed. &#x20;

The vast majority of invitations will be created automatically at the appropriate point of the workflow, and you will interact with invitations via the UI and stages within to change settings.&#x20;

### Structure of Invitations

See the [API Reference](https://docs.openreview.net/reference/api-v2/entities/invitation) for a detailed description of each field of the invitation. The main fields that you will interact with are:

* `id`: A unique identifier (e.g., `ICLR.cc/2025/Conference/-/Area_Chair_Registration`)
* `invitees`: Who is allowed to use the invitation (e.g. Area Chairs)
* `signatures`: Who issued the invitation (typically a venue or program chair group)
* `edit`: Defines the type of object that can be posted (e.g., `note`, `edge`)
* `reply` or `content`: Schema specifying required fields, validation, and structure
* `readers`, `writers`, and `signatures` constraints for resulting entities

### Creating Invitations

The vast majority of invitations will be created automatically at the appropriate point of the workflow, and you will interact with invitations via the UI and stages within to change settings.&#x20;

In some cases, you may need to create custom invitations to accommodate less commons workflow. In this case, see guidance for those specific stages, or the Custom Stage.

### Editing invitations

1. **Pre-created invitations:** The vast majority of edits to invitations are made via the [venue configuration form](https://docs.openreview.net/getting-started/hosting-a-venue-on-openreview/navigating-your-venue-pages). To maintain consistency across the venue, the values in the venue configuration will overwrite any changes made directly to invitations. Examples: [Hiding submission fields](https://docs.openreview.net/how-to-guides/workflow/how-to-hide-submission-fields-from-reviewers), [releasing reviews](https://docs.openreview.net/how-to-guides/workflow/how-to-release-reviews)
2. **Custom Invitations:** For custom invitations that are not configurable in the venue configuration form, you may need to make changes directly to those invitations. In those cases, changes can be made in the Invitation's page, found on your venue's group page: <kbd><http://openreview.net/group/edit?id={venue\\_id}></kbd>
3. **Changes to per-paper invitations:** If you need to make programmatic changes to per-paper invitations for many submissions, you may want to make these changes programmatically.&#x20;

### Deleting invitations

Rather than outright deleting invitations, we use the expiration date. Update the `exp_date`  field of the invitation to now or a past time (in ms time), which will stop any new posts from being made with the invitations. Example: [Updating Submission Expiration](https://docs.openreview.net/how-to-guides/workflow/how-to-change-the-expiration-date-of-the-submission-invitation).&#x20;
