Headless CMS > References
Date/Time and Identity (On/By) Meta Fields
Learn about the date/time and identity-related meta fields that are available for content entries.
The new meta fields outlined in this article are available since v5.39.0.
Introduction
Apart from the fields that are defined in a content model by the user, all content entries also have a set of date/time and identity-related meta fields. A couple of examples:
revisionCreatedOn- the date/time when an entry revision was createdrevisionFirstPublishedOn- the date/time when an entry revision was first publishedcreatedOn- the date/time when an entry was createdlastPublishedOn- the date/time when an entry was last published
These meta fields are automatically populated by the system, and they can be used to display information about the entry, such as when it was created, modified, or published, and by whom.
Developers can use these fields when querying entries, for example via the Headless CMS GraphQL API:
They can also use them in their custom JavaScript (TypeScript) code, for example, when hooking onto lifecycle events:
Revision-Level and Entry-Level Meta Fields
The meta fields are available at two levels: revision-level and entry-level.
Revision-level fields include the revision prefix in their names, and they contain information about the revision of an entry. For example, revisionCreatedOn is the date/time when the revision was created, and revisionCreatedBy is the identity of the user who created the revision.
On the other hand, entry-level fields do not contain the revision prefix in their names, and they contain information about the entry itself. For example, createdOn is the date/time when the entry was created, and createdBy is the identity of the user who created the entry. These fields do not change when a revision is created, modified, or published, nor if new revisions are created, modified, or published.
Meta Fields
The following table lists all the date/time and identity-related meta fields that are available for content entries.
Revision-Level Meta Fields
| Field | Description | Can be null |
|---|---|---|
revisionCreatedOn | The date/time when an entry revision was created. | No |
revisionModifiedOn | The date/time when an entry revision was last modified. | Yes |
revisionSavedOn | The date/time when an entry revision was last saved. | No |
revisionFirstPublishedOn | The date/time when an entry revision was first published. | Yes |
revisionLastPublishedOn | The date/time when an entry revision was last published. | Yes |
revisionDeletedOn | The date/time when an entry revision was last deleted / moved to the trash bin. | Yes |
revisionRestoredOn | The date/time when an entry revision was last restored from the trash bin. | Yes |
revisionCreatedBy | The user who created an entry revision. | No |
revisionModifiedBy | The user who last modified an entry revision. | Yes |
revisionSavedBy | The user who last saved an entry revision. | No |
revisionFirstPublishedBy | The user who first published an entry revision. | Yes |
revisionLastPublishedBy | The user who last published an entry revision. | Yes |
revisionDeletedBy | The user who last deleted / moved to the trash bin an entry revision. | Yes |
revisionRestoredBy | The user who last restored an entry revision from the trash bin. | Yes |
Entry-Level Meta Fields
| Field | Description | Can be null |
|---|---|---|
createdOn | The date/time when an entry was created. | No |
modifiedOn | The date/time when an entry was last modified. | Yes |
savedOn | The date/time when an entry was last saved. | No |
firstPublishedOn | The date/time when an entry was first published. | Yes |
lastPublishedOn | The date/time when an entry was last published. | Yes |
deletedOn | The date/time when an entry was last deleted / moved to the trash bin. | Yes |
restoredOn | The date/time when an entry was last restored from the trash bin. | Yes |
createdBy | The user who created an entry. | No |
modifiedBy | The user who last modified an entry. | Yes |
savedBy | The user who last saved an entry. | No |
firstPublishedBy | The user who first published an entry. | Yes |
lastPublishedBy | The user who last published an entry. | Yes |
deletedBy | The user who last deleted / moved to the trash bin an entry. | Yes |
restoredBy | The user who last restored an entry from the trash bin. | Yes |
FAQ
What Is the Difference BetweenmodifiedandsavedMeta Fields?
The difference between modified and saved meta fields is that modified fields can be null if the entry has not been modified yet, while saved is never null because it is updated even when the entry is created.
So, if we were to create a new entry, the createdOn and savedOn fields would have the same value, but the modifiedOn field would be null because the entry has not been modified yet. Only after the first update, the modifiedOn field would have a value different from null. Actually, after the first update, the savedOn and modifiedOn will always have the same value.