Transferring systemDNS zones to Storefront

When you import a domain into Storefront, the domain's nameservers are not changed. If the domain was using OpenSRS SystemDNS nameservers, it keeps those after import — which means your customer can see the domain in their Storefront account, but cannot edit its DNS records there. DNS management for SystemDNS domains still happens in the RCP.

This article explains how to manually migrate a domain's DNS zone from OpenSRS SystemDNS to Storefront DNS, so your customers can manage their own DNS records directly in the Storefront customer portal.

SystemDNS vs. Storefront DNS

	SystemDNS (OpenSRS)	Storefront DNS (Shopco)
Nameservers	ns1.systemdns.com, ns2.systemdns.com, ns3.systemdns.com	a.ns.shopco.com, b.ns.shopco.com, c.ns.shopco.com
Where records are managed	Reseller Control Panel	Storefront Manager + customer portal
Can customers edit DNS?	No — must contact you	Yes — self-serve in Storefront

Do Step 2 before Step 3. Switching nameservers before recreating records causes DNS downtime. Always recreate records in Storefront first, then switch.

Before you start

You need:

The complete set of DNS records from the domain's current SystemDNS zone — gather these before making any changes
The domain already imported into your Storefront (see Importing OpenSRS domains)
The customer's account accessible in Storefront Manager

Step 1: Retrieve the DNS zone from the OpenSRS Control Panel

Log in to the Reseller Control Panel.
Go to the Domains section and search for the domain.
Select the domain to open its details.
Scroll to the DNS section and note all records — the record type, name, value, and TTL for each. Copy these down before proceeding.

Common record types to look for: A, AAAA, CNAME, MX, TXT, SRV. Pay particular attention to any SPF or DKIM records in TXT entries — these are critical for email delivery and easy to overlook.

Step 2: Add the DNS records in Storefront

Log in to Storefront Manager.
Go to Customers and select the customer whose domain you're migrating.
Click Log in as Customer to open the customer's account in a new tab.
Select the domain name.
In the DNS Records section, click Add DNS Record.
Set the record type, enter the name and value from your SystemDNS zone, and set the TTL.
Click Add Record to save.
Repeat for each record in the zone.

Take care with MX records — the priority value must match what was set in SystemDNS. Missing or incorrect MX records will break email delivery when the nameserver switch happens.

Step 3: Switch the nameservers

Once all DNS records are recreated and verified in Storefront, switch the domain to Storefront nameservers.

Still in the customer's Storefront session (from Step 2), navigate to the Nameservers section on the domain's page.
Click Reset to default.
Confirm the change.

Storefront updates the nameservers to a.ns.shopco.com, b.ns.shopco.com, c.ns.shopco.com.

DNS propagation typically takes between a few minutes and 48 hours depending on the domain's TTL and resolver caching. The SystemDNS zone continues to resolve until propagation completes, so there should be no service interruption if the records were correctly recreated.

What your customer sees after the switch

Once the nameserver change propagates, the customer can manage all their DNS records directly from their Storefront account. They can add, edit, and delete A, AAAA, CNAME, MX, TXT, and SRV records from the domain's details page in the Storefront portal.

Troubleshooting

The customer's website or email stopped working after the nameserver switch

A record is missing or incorrect in the Storefront DNS zone. Log in as the customer in Storefront Manager and compare the current Storefront DNS records against the original SystemDNS zone you copied in Step 1. Add or correct any missing entries. Changes propagate within the DNS TTL window.

The DNS Records section doesn't appear on the domain's page in Storefront

The nameserver switch to Storefront DNS must be completed before DNS records become editable in the Storefront customer portal. If the domain is still using SystemDNS nameservers, complete Step 3 first.

I switched nameservers before recreating the records

If DNS is now broken, switch the nameservers back to SystemDNS immediately, then start again from Step 2. To revert, log in as the customer in Storefront Manager, go to the domain's Nameservers section, and manually enter the original SystemDNS nameservers. Once the records are correctly recreated in Storefront DNS, switch again.

I'm not sure which records to recreate — there are too many

Work through each record type methodically: start with A records (the domain itself and any subdomains), then MX (email), then CNAME, then TXT (SPF, DKIM, verification records). Leave SRV for last. Checking email deliverability after the switch is strongly recommended.

Questions? Contact OpenSRS Support.