Skip to content

Staff custom domain

For OwnerBusiness and above

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.

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.ng or app.demomart.ng - never the same host as the public shop.
  • Upgrade first if Billing still says Growth.
  1. 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.

  2. 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.

  3. Add TXT or CNAME

    At your DNS host, either:

    • TXT at _akoole-verify.pos.demomart.ng (or _akoole-verify.{domain}) with akoole-domain-verification={token}
    • or CNAME {domain} → cname.akoole.com

    Wait for DNS to propagate. Do not point this record at the shop CDN.

  4. 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.

  5. 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 to cname.akoole.shop. Never serve POS and the public shop on one hostname.

  6. 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.com keeps working. The public shop stays on {slug}.akoole.shop.

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.

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.