Staff custom domain
Request a staff hostname, add TXT or CNAME at your DNS host, verify, and sign in at that host without exposing POS on the public shop domain.
Before you start
Section titled “Before you start”Owners on Business or Enterprise. Starter and Growth staff stay on app.akoole.com only.
- You can edit DNS for a domain you own (for example
demomart.ng). - Decide a staff-only host such as
pos.demomart.ngorapp.demomart.ng- never the same host as the public shop. - Upgrade first if Billing still says Growth.
-
Open Domain settings
Go to Settings → Domain (
/settings/domain). If your plan is below Business, you will see an upgrade path instead of DNS instructions. -
Request the hostname
Enter
pos.demomart.ng(your real host) and save. Status becomes pending. Akoole shows DNS instructions and a verification token. This is the staff custom domain only. -
Add TXT or CNAME
At your DNS host, either:
- TXT at
_akoole-verify.pos.demomart.ng(or_akoole-verify.{domain}) withakoole-domain-verification={token} - or CNAME
{domain}→cname.akoole.com
Wait for DNS to propagate. Do not point this record at the shop CDN.
- TXT at
-
Verify
Click Verify. On success, status is verified. Sign in at
https://pos.demomart.ng. Cashiers should install the PWA from this host if it is the one they will use. -
Keep shop domains separate
The public shop custom domain (for example
shop.demomart.ng) is configured under Storefront, with different TXT (_akoole-shop-verify…) or CNAME tocname.akoole.shop. Never serve POS and the public shop on one hostname. -
Remove if you change hosts
Remove the staff domain when you retire it, then delete the DNS records so nobody else can collide.
app.akoole.comkeeps working. The public shop stays on{slug}.akoole.shop.
What success looks like
Section titled “What success looks like”Staff open POS on your hostname, status is verified, and shoppers still use {slug}.akoole.shop or the shop custom domain - never the staff host.
If something goes wrong
Section titled “If something goes wrong”Verify fails
DNS is slow, the TXT name is missing the _akoole-verify prefix, or you put shop records on the staff domain. Recheck the instruction panel and wait, then verify again.
Page tells me to upgrade
Staff custom domains start at Business. Change plan as Owner with a verified email.
Customers hit POS
You published the staff host as “the website.” Give shoppers the shop URL instead.