-
Notifications
You must be signed in to change notification settings - Fork 16
Using a custom domain
Cyril Rohr edited this page Feb 10, 2026
·
4 revisions
By default, pullpreview instances will use a domain name such as pr15-my-beautiful-code-1-2-3-4.my.preview.run.
In addition to the default my.preview.run, PullPreview provides these built-in DNS suffixes:
rev1.click, rev2.click, rev3.click, rev4.click, rev5.click, rev6.click, rev7.click, rev8.click, rev9.click
These are useful when you need to spread across multiple domains to avoid Let's Encrypt rate limits (50 certificates per registered domain per week).
with:
dns: rev1.clickIf you wish to use a custom domain instead (e.g. pr15-my-beautiful-code-1-2-3-4.preview.domain.com), you can do so by:
- assuming you own
domain.comand want previews to be under<ENV-NAME>.preview.domain.com, add a record in your DNS zone so thatpreview.domain.comis aNSrecord forxip.preview.run. - add the
dns[input] parameter in your workflow file to indicate the domain you want to use:
with:
dns: preview.domain.comThat's it! Using a custom domain also gives you an independent Let's Encrypt rate-limit quota.