❓ Admin Frequently Asked Questions (FAQ)

This document covers common questions, causes, and checklist items regarding backup/restore, external media storage integration, and dashboard statistics in the admin page.

🗄️ Q1. An error occurs during backup data import (Restore).

Checklist when an error occurs during restore after choosing a backup file.

💡 Core Checklist

1. Corrupted Backup File:
   • If the text was not saved properly during download, restore may fail. Open the .json file in a text editor to verify that it has a valid data format.
2. Menu Path Mismatch:
   • You must use the restore menu that matches your data type. Post data must be restored under the Data Backup & Restore section of the Content Backup menu; image media files must be restored under the Media Backup & Restore section of the Content Backup menu; and complete system data must be restored under the Full System Backup & Restore section of the Site Settings menu.
3. Database (D1) Binding:
   • Verify in the Cloudflare management console that your database (D1) connection binding is properly associated.

📂 Q2. Upload or display errors occur after switching the media storage provider.

Analysis of causes when upload errors occur or images are not displayed after switching the storage provider from default KV to R2, Supabase, or ImageKit.

💡 Core Checklist

1. Cloudflare R2:
   • Verify if the IMAGES R2 bucket binding is correctly associated in your project settings (wrangler.json).
2. Supabase Storage:
   • Check the accuracy of the entered API endpoint (supabase_storage_url), Service Role Key (supabase_storage_key), and bucket name (supabase_storage_bucket). The bucket's access control list (ACL) must be set to Public for images to be visible externally.
3. ImageKit.io:
   • Check the format of the entered endpoint URL (imagekit_url_endpoint) and inspect cross-origin resource sharing (CORS) settings.
4. Upload Size Restrictions:
   • High-resolution images may fail to upload due to size limitations per request in the edge server environment. Shrink the original image dimensions before uploading.

📊 Q3. Dashboard analytics charts display only demo data.

Checklist when demo data is displayed instead of actual traffic metrics on the main dashboard.

💡 Core Checklist

• Cause: If the Google Analytics 4 (GA4) API credentials/environment variables are missing or incorrect, placeholder demo data is rendered to prevent dashboard crashes.
• Setup Instructions: Add the following environment variables to the Cloudflare Pages settings and redeploy:
  • GA4_PROPERTY_ID: Google Analytics Property ID
  • GA4_CLIENT_EMAIL: Google Cloud Service Account Email
  • GA4_PRIVATE_KEY: Google Service Account Private Key
• Google AdSense: If you wish to integrate the AdSense revenue dashboard, verify that the ADSENSE_ACCOUNT_ID environment variable is correctly set.