Prismic Glossary
Definitions of key terms in Prismic.
application programming interface (API)
Technical procedures for communicating between two pieces of technology. Often refers to HTTP APIs on the internet, like Prismic’s, where data is sent to or retrieved from a server.
archiving
Unpublishing a Prismic document and moving it to the archive in the user interface. Archived documents are excluded from the API.
boolean
A field that stores true
or false
.
color
A field that stores a hex color code.
component
A reusable piece of code (.vue
, .jsx
, .js
, .svelte
, .ejs
, .pug
) for generating a part of a user interface.
content delivery network (CDN)
A network of servers to distribute content globally. Prismic uses a CDN to optimize query response times.
content management
The processes for creating and modifying the content of a website. Content management describes the policies, procedures, standards, roles, resources, and schedules to create, modify, and delete content.
content management system (CMS)
Software for creating and modifying content for a website.
content modeling
Creating content structures. In a Prismic repository, the largest unit of a content model is a Custom Type. Custom Types are composed of static zones and slice zones, which are composed of Fields and slices, respectively. Slices are composed of Fields. Fields are the smallest unit of a content model.
content relationship
A structured field that stores internal relationships. Content relationships are designed to facilitate pulling content from another document, such as displaying related content.
custom type
A model for a type of document, (e.g. page, post, author, recipe, event). Custom types configure what fields and slices are available on a document.
Custom Types API
Prismic’s read-write Rest API endpoint to retrieve and modify Custom Types and slices, located at https://your-repo-name.cdn.prismic.io/customtypes
Dashboard
The first screen you see when you log in to Prismic: a list of your repositories, located at prismic.io/dashboard
date
A field that stores a calendar date. The date is delivered in ISO format (YYYY-MM-DD).
deleting
Erasing a document that has already been archived. Deleted documents are not recoverable.
deploying
Publishing a website on the internet.
document
A unit of content in Prismic corresponding to an entity on a website (e.g., a page, post, author, tag, menu).
Document API
Prismic’s read-only Rest API endpoint for content, located at https://your-repo-name.cdn.prismic.io/api/v2/documents/search
Editor
The editor interface, where a user can edit the content of a single document.
Embed
A field that stores an oEmbed URL.
Entry API
Prismic’s read-only Rest endpoint for metadata about a repository (including refs, which are necessary for requests to the Document API), located at https://your-repo-name.cdn.prismic.io/api/v2
environments
A premium Prismic feature that allows you to clone the entirety of your production repository — including all custom types, documents, and media files — so that you can make content changes in a development environment.
field
The most elementary component of a Prismic model. Prismic has 18 different field types.
There are eight simple fields, which each return a primitive value (e.g. 8
, false
, "Dog"
): UID, boolean, color, date, timestamp, number, key text, and select.
There are ten structured fields, which each return an object value: title, rich text, image, content relationship, link, link to media, embed, geopoint, repeatable group, and integration.
geopoint
A field that stores a location on Earth. The location is stored as a latitude and longitude.
GraphQL
A data query language for APIs, created by Facebook. Gatsby uses a GraphQL API layer, and Prismic offers a GraphQL API endpoint. GraphQL stands in contrast to REST. Compared to REST, GraphQL allows for more complex querying.
GraphQL API
Prismic’s read-only GraphQL API endpoint, located at https://your-repo-name.cdn.prismic.io/graphql
GraphQL Explorer
A web interface for building queries to the Prismic GraphQL API, located at https://your-repo-name.prismic.io/graphql
history
A log of past versions of a document in Prismic. Prismic saves all previous document versions in the history.
HTML serializer
The former name of the rich text serializer.
image
A field that stores an image with cropping, alt text, and various sizes.
integration
A field that stores data synced from a third-party API.
Integration Fields Write API
Prismic’s write-only Rest API endpoint to create, modify, and delete content in an integration field database, located at https://if-api.prismic.io/if/write/your-repo-name--catalog-name
key text
A field that stores a text string without formatting.
Legacy Builder
The interface for constructing content models in the Prismic platform. The Legacy Builder is being superseded by Slice Machine and will be deprecated in the future.
link
A field that stores a link to the web, to media, or to an internal Prismic document. The link field is designed to facilitate creating links (href
s).
link resolver
A function that receives a document, a link field, or a content relationship field as a parameter and returns a URL path for the document.
link to media
A field that stores a link to an item in the Media Library.
locale
A locale is a representation of the content of a Prismic repository for a specific region and language. Every Prismic repository has one “master” locale, which is the default language and region for content in the repository. Users may create additional locales and translate content into them.
locale code
The API ID for a locale. Prismic includes common locales with ISO language codes. Users can also define their own locales with custom locale codes.
Media Library
The media management interface, where users can upload, delete, and select media (images, PDFs, ZIP files) and edit media’s default metadata.
mock data
JSON that imitates content from the Prismic API to simulate slices in Slice Machine.
number
A field that stores a number.
params
A variable passed into a JavaScript function. Short for “parameters.” Contrasts to “argument,” which is the real value passed as a param when a function is invoked.
predicate
A search filter for the Document API.
previewing
Securely rendering unpublished content changes in Prismic live in the context of a web app.
publishing
Making a version of a document live on the Prismic API.
querying
Sending a GET request to a Prismic repo’s Document or GraphQL API to retrieve content.
ref
An ID that is updated every time content is changed in the repository. Every repository has refs for the most recently published content, all drafts, and all releases, which are available on the Entry API. Queries to the Document API must include a ref to specify what version of the content to return. Refs enable caching, which significantly speeds up API responses. Prismic usually keeps the six most recent refs (including the current one) and deletes older ones, therefore a ref cannot be reliably used to query outdated content versions.
release
A release is a collection of content changes that can be previewed and published together. In a release, documents can be created, changed, or deleted.
repeatable group
A field that stores a repeatable set of other fields.
Repository
An isolated collection of content in Prismic. A repository stores all of the content for a project. It contains all of the documents, media, environments, translations, and settings for your project.
REST
A standard API query language.
REST API Browser
A graphical user interface for constructing queries to the Document API. Visit https://your-repo-name.prismic.io/api/v2
to access this.
rich text
A field that stores formatted text, images, and embeds.
rich text serializer
A function or an object that describes how rich text elements should be rendered.
route resolver
An API option that allows users to define rules for building URL paths for documents, which the Prismic API will return as the url
property on each document.
routing
How pages of a website are organized by the structure of URL paths.
select
A field that stores one of a collection of predefined values.
slice
A slice is a section of a webpage. Slices are freely arranged in a document’s slice zone. Each slice is rendered by a UI component in the web application (e.g. React, Vue, Svelte). Slices allow content editors to compose complex UIs.
Slice Machine
A local development tool for developing with Prismic slices in your codebase.
slice simulator
The slice simulator is a mini-app that simulates what your slices will look like in production, using mock data. The slice simulator makes development faster and allows Slice Machine to take screenshots of the simulated slices to display in the Prismic editor.
slice zone
A container for slices. Prismic provides SliceZone
components for rendering slices in popular front-end JavaScript frameworks.
starter
A sample project launched from the CLI.
static zone
A container for immovable and non-repeatable fields, generally used for document metadata.
structured text
The custom data format Prismic uses for rich text. Structured text is stored as JSON. Each rich text field is an array containing one object for each block-level element. The objects describe the content of the element and any inline elements. Structured text must be serialized before rendering. Prismic provides development kits for this, such as @prismicio/richtext
.
tagging
Prismic’s built-in system for organizing content.
Tag API
Prismic’s read-only Rest endpoint for a list of all tags used in a repository, located at https://your-repo-name.cdn.prismic.io/api/tags
templating
Creating UI components that use data from Prismic (e.g. .vue
, .jsx
, .js
, .svelte
, .ejs
).
timestamp
A field that stores a calendar date and time.
title
A field similar to the rich text field that stores a single text heading, with formatting.
UID
A metadata field that formats and stores a human-readable, SEO-friendly identifier for each document, unique to the Custom Type. Used for constructing URLs. Stands for “unique identifier.”
versioning
Tracking changes to work. Codebases are generally versioned with a version control system like git. Content in Prismic is versioned with the history tool. Content models in Slice Machine can be versioned as part of a codebase.
webhooks
HTTPS requests sent by Prismic to a user-defined endpoint on certain actions (e.g. document published). Used to trigger actions (like a website rebuild) on content changes.