Troubleshooting & FAQ

During daily operations of your SymbolFlow Appsuite website, if you encounter unexpected behaviors, consult this troubleshooting guide first. The vast majority of issues stem from browser caching or normal DNS propagation intervals.

---

1. Why Aren’t CMS Changes Visible on the Live Website?

This is the most common question among new operators. Follow this 3-Step Diagnostic Checklist:

Diagnostic Steps:

1. Check if you clicked “Publish”: Payload CMS utilizes a draft system. If you modified text and clicked “Save Draft”, changes remain private. You must click the blue Publish button in the top-right corner.
2. Check if you triggered a Site Deployment: Appsuite is a high-performance static compilation website. After database updates, the public frontend requires a rebuild to generate the new static files. Return to the SymbolFlow Platform Dashboard and click Deploy on your website application node.
3. Hard-refresh your Local Browser Cache: Production environments employ aggressive caching. Your browser may still hold stale assets. Execute a hard refresh:
   • Windows / Linux: Ctrl + F5
   • macOS: Cmd + Shift + R

---

2. Why Didn’t Modifying the English Layout Update the Chinese Page?

The Architectural Explanation:

To support multinational enterprises targeting distinct global regions with customized marketing blocks (e.g., environmental compliance blocks for Europe vs. large infrastructure case studies for the Middle East), Appsuite’s underlying layout (Page Block array) is natively localized.

The Solution:

Modifying page blocks in the English view does not automatically mirror to Chinese.

• Switch the language dropdown at the top of the CMS to Chinese (zh);
• Add or configure the corresponding page blocks for that locale;
• Click Publish independently for each language.

---

3. Dashboard Reports “Domain verification records not yet ready. Please try again in 5 minutes”?

The Explanation:

When you click “Save Changes” in the custom domain modal, automated validation routines query authoritative global DNS root servers for your CNAME or TXT record.

Global domain registrars (such as Cloudflare, GoDaddy, Namecheap, or Aliyun) require a brief propagation window (typically 3 to 10 minutes) to broadcast records globally.

The Solution:

1. Verify that your DNS record value contains no trailing spaces or misconfigured hostnames;
2. Wait patiently for 5 to 10 minutes;
3. Return to the Appsuite custom domain modal and click Save Changes again.

---

4. How to Resolve Excel Batch Import Errors?

Errors encountered during Excel variant imports typically stem from spreadsheet formatting discrepancies:

Error Message	Root Cause	Fix / Resolution
Missing required sheet "SKUs"	Workbook is missing the SKUs tab	Ensure the first sheet is strictly named SKUs (case-sensitive)
Missing required sheet "Dictionary"	Workbook is missing the Dictionary tab	Ensure the second sheet is strictly named Dictionary
Column header mismatch	Header names do not match CMS specColumns	Ensure headers from Column D onward match the exact Column Key in CMS (e.g. thread, d, h)
Image file not found in ZIP	Image file referenced in Column E is missing in the ZIP	Check for filename typos, case mismatches, or invalid symbols within the ZIP archive

[!TIP] Recommended Approach: Download our benchmark template VD-Sample.xlsx directly from the Official Sample Assets & Download Center and populate your data over the existing columns to ensure flawless compatibility.

---

5. How Do I Reset Forgotten Admin Credentials?

If you lose your Payload CMS administrator password:

1. Log into the SymbolFlow Platform Dashboard (app.symbolflow.com);
2. Locate your Appsuite project and navigate to the Settings tab;
3. Under Admin Credentials, click Reset Admin Credentials;
4. The system will securely generate a new password for immediate login.