Domains

The Domains section allows you to manage the web addresses (URLs) customers use to access your store. You can create a free subdomain provided by Soppiya or connect a professional custom domain you purchased from a third-party provider.

Location: Settings → Domains

---

Domains Overview

The main screen lists all web addresses currently connected to your store.

• List View: Displays every domain (e.g., abc.soppiya.xyz, rawzafood.com).
• Primary Badge: The domain marked as Primary for online store is the main address customers see in their browser bar.
• Visit Button: Click on a domain and you will see a Visit button that opens that specific URL in a new tab.

---

Option 1: Add a Soppiya Domain

Every store comes with the ability to create subdomains ending in .soppiya.xyz. This is the fastest way to get your store online.

1. Click the Add soppiya domain button.
2. Enter Name: Type your desired store name (e.g., mybrand).
   • Note: You do not need to type the extension. The system automatically adds .soppiya.xyz to the end.
3. Click Save.

Immediate Activation

Soppiya domains require no technical setup. Once you click save, the domain is active instantly.

---

Option 2: Connect Existing Custom Domain

If you own a professional domain (like example.com) purchased from providers like GoDaddy, Namecheap, or Squarespace, you can connect it here.

Step 1: Update Your Nameservers First

Before you add the domain to your store, you must point it to our servers.

1. Log in to the account where you bought your domain (your domain provider).
2. Find the settings for Nameservers (sometimes called "DNS Management").
3. Change your nameservers to these exact addresses:
   • ns1.soppiya.com
   • ns2.soppiya.com
4. Save the changes.

note

It can take anywhere from a few minutes to 1-48 hours for these changes to work across the internet.

How to check status: You can verify if your nameservers have updated by using a tool like DNSChecker.org. Enter your domain and select NS from the dropdown. If you see ns1.soppiya.com in the results, the connection is working.

Step 2: Verify Connection

Once the nameservers have propagated:

1. Log in to your store admin panel.
2. Go to Settings.
3. Navigate to the Domains page.

Step 3: Enter and Save Your Domain

1. Click on the button titled "Connect existing domain".
2. In the text box, type your full domain name (e.g., example.com).
3. Click the Save button.
4. After succesfully saving the domain soppiya will redirect you to the Domains page and from the list you can see your DNS record.

---

Managing DNS Records

Once a custom domain is successfully connected to Soppiya, we automatically configure the necessary DNS records for you. You can view or edit them if you have advanced needs.

1. Click on the custom domain name in your list (e.g., example.com).
2. You will see the DNS Settings table.

Actions:

• Add Record: Click Add DNS Record to create new entries. You can add common types like A, CNAME, or TXT.

  Need help understanding these types? Jump to the Technical Glossary below.

• Delete: Click the red X next to a record to permanently remove it.

---

Changing Default Domain

You can select which domain acts as the internal fallback for the system.

1. Click Change default domain.
2. Select a domain from the dropdown list.
3. Click Save.

Important Distinction

Changing the Default Domain here does not change the "Primary" domain your customers see. To change the public-facing domain for your storefront, please navigate to the Markets settings tab.

---

Deleting a Domain

To remove a domain from your store:

1. Click on the domain name in the list.
2. Click the Delete domain button at the bottom.
3. Confirm: A warning modal will appear. Read it carefully.
4. Click Yes, Remove.

Risk of Disruption

Deleting a domain will immediately break any links you have shared on social media. It may also disrupt your SSL (Security) certificate. Only delete a domain if you are sure you no longer need it.

---

Technical Glossary: Understanding DNS

DNS settings can feel complex, but they are simply the instructions that tell the internet where to find your store.

What is DNS?

DNS stands for Domain Name System. Think of it as the "Phonebook of the Internet."

• How it works: Computers communicate using numbers (called IP addresses, like 182.48.91.250). Humans find it hard to remember random numbers, so we use names (like soppiya.com) instead.
• What it does: When a customer types your domain name into their browser, the DNS system instantly looks up that name in the "phonebook," finds the matching IP address number, and connects them to your Soppiya store.

DNS Record Types

When adding a record, you must select a Type. Use this guide to choose the right one for your goal.

Type	Full Name	Usage & Real-World Example
A	Address	Points your domain to a server IP. 🟢 Scenario: You want your root domain (example.com) to load your Soppiya store. You would create an A Record pointing to Soppiya's IP address.
CNAME	Canonical Name	Points a subdomain to another service. 🟢 Scenario: You want to host a blog at blog.example.com using Soppiya Blog. You would use a CNAME to point "blog" to that service provider.
MX	Mail Exchange	Directs email traffic. 🟢 Scenario: You want to receive emails at info@yourstore.com. You would add MX records provided by your email host (like Google Workspace, Zoho, or Outlook).
TXT	Text	Verifies ownership (Security). 🟢 Scenario: Facebook or Google Search Console asks you to "paste this code into your DNS" to prove you actually own the website.
NS	Nameserver	Delegates management. 🟢 Scenario: Tells the world that Soppiya manages your domain settings. This is usually set to ns1.soppiya.com.
AAAA	Address (IPv6)	Advanced Version of A Record. Functions exactly like an A record but uses the newer, longer IPv6 address format.
SRV	Service	Network Services. Rarely used for stores. Mostly used if you are setting up an office network for VoIP phones or Instant Messaging.
PTR	Pointer	Reverse Lookup. The opposite of an A record. It maps an IP back to a name. You will likely never need to touch this.
SOA	Start of Authority	Administrative Data. Contains technical details like how often the "phonebook" refreshes. This is usually managed automatically by Soppiya.

Other Key Terms

• Host: The specific part of your domain the record affects.

  • @ : Represents the Root Domain (e.g., just example.com).
  • www : Represents the Subdomain (e.g., www.example.com).
  • blog : Represents a custom page (e.g., blog.example.com).

• TTL (Time To Live): How long (in seconds) the internet "remembers" a record before checking for updates.

  • 3600 : 1 Hour. (Standard for most records).
  • 300 : 5 Minutes. (Use this if you are testing changes and want them to update quickly).