Edit a Document's Unique Identifier

The Prismic editor has a special field called the "UID" field. UID stands for "unique identifier."


The Prismic editor has a special field called the "UID" field. UID stands for "unique identifier." The UID is often (though not always) used to set a document's URL.

Configure Unique Identifiers

For information on how to add a UID field to a custom type, read the UID field Reference.

Screenshot of a UID field in Prismic.

UIDs are automatically formatted to be URL-friendly.

UIDs are also unique. Prismic ensures that no two documents with the same custom type have the same UID. Even if you change a document's UID, you can not use the old UID on another document unless you delete the original document.

What if I need to use a UID that has previously been used?

To reassign a UID, duplicate the document associated with the UID and delete the document's original version. Now you'll be able to reuse the UID.

When you enter text in the UID field, Prismic will automatically format it and check to see if it's unique. You won't be able to save your document if the UID is not filled in and unique.

If you don't fill it manually, the UID will automatically populate with text from another text field.


Was this article helpful?
Not really
Yes, Thanks

Can't find what you're looking for? Spot an error in the documentation? Get in touch with us on our Community Forum or using the feedback form above.