[▲ Vercel Community](/) · [Categories](/categories) · [Latest](/latest) · [Top](/top) · [Live](/live)

[Feedback](/c/feedback/8)

# Improve documentation about GitHub Actions

51 views · 1 like · 4 posts


Jakub T. Jankiewicz (@jcubic) · 2025-11-19

I’m not sure where I should propose this, so I’m adding this here:

The guide about deploying to Vercel from GitHub actions

https://vercel.com/guides/how-can-i-use-github-actions-with-vercel

is missing important feature about custom domains. I got an error when following the documentation, found in on [GitHub discussion](https://github.com/vercel/vercel/discussions/4622#discussioncomment-7357282).

There is should be a link to this article:

https://vercel.com/guides/how-to-alias-a-preview-deployment-using-the-cli

Note: if someone is taking the time to deploy from GitHub action, he/she probably have a custom domain by now.

Another issue with docs is this issue:

https://github.com/vercel/vercel/issues/14304

It requires adding `--scope <your org>` to the Vercel CLI.

This can be solved by updating documentation.


Pauline P. Narvas (@pawlean) · 2025-11-19

Thank you for your feedback, Jakub! I've shared this with the docs team.


Jakub T. Jankiewicz (@jcubic) · 2025-11-19 · ♥ 1

You may also mention Prisma, a popular interface to SQL database (not sure if you can call it ORM).

There is an issue with deploying Next.js app from GitHub action if you use Prisma.

The solution is in this StackOverflow answer:

https://stackoverflow.com/a/79622676/387194

It only happen from GitHub action, when you use Vercel to deply, it works fine. It’s probably also a good idea to add this to docs. So people don’t get errors and then waste time searching or give up.


Pauline P. Narvas (@pawlean) · 2025-11-20

Heard. Appreciate the detail! The docs team are aware :slight_smile: