Chery Caribbean — User Manual

For: Content managers and administrators System: Admin Panel (at /admin) Skill level required: No technical experience needed

Setting Up a New Website Instance

If you are setting up a new dealer website (a separate instance for a different country or territory), an onboarding guide is available to help you collect all the information the development team will need.

👉 Open the New Instance Onboarding Guide (opens in a new tab)

The guide walks through everything required: dealership identity, contact details, branding, vehicle catalog, page content, and the go-live checklist. It also includes a Download (.pdf) button to export a fillable version you can complete offline and send to the team.

Table of Contents

1. Getting Started
2. Admin Panel Overview
3. Site Configuration
   • 3a. Cache Refresh
   • 3b. Global WhatsApp Button
4. Navigation
5. Home Page Banners
6. Vehicle Catalog
7. Vehicles
   • Duplicating a vehicle
   • Tab 5 — Interior & Safety
8. Articles (News & Publications)
9. Exterior Colors
10. Interior Colors
11. About Us
12. Warranty Page
13. Tips & Common Tasks
14. Sync
15. Troubleshooting
16. Transactional Emails
17. GDPR & Cookie Consent

1. Getting Started

Accessing the Admin Panel

The Admin Panel is the control centre for all website content. To access it:

1. Open your web browser
2. Navigate to your website address followed by /admin Example: https://chery.sx/admin
3. You will be redirected to the login page automatically

Logging In

Login page

1. Enter your Email address
2. Enter your Password
3. Click Sign In

If you do not have login credentials, contact your system administrator to have an account created for you in Auth0.

Resetting Your Password

If you have forgotten your password:

1. Click "Forgot password?" on the login page
2. Enter your email address and click "Send Reset Link"
3. Check your inbox for a password reset email
4. Follow the link in the email to set a new password

Signing Out

Click Sign out in the top-right corner of the admin panel (in the top bar, next to your name). It is visible on every admin page.

2. Admin Panel Overview

Once logged in, you will see the Admin Panel. It has two main areas:

Admin panel layout

Dashboard

Settings

Site Config

Navigation

Catalog

Banners

Warranty

About Us

Content

Articles

Vehicles

Colors

Exterior

Interior

Tools

Analytics

Sync

Manual

A

Edit

Edit

Edit

Key concepts

The Save Changes button

Every editable page has a Save Changes button. Changes only go live after you click it.

There is no "Draft" step. Clicking Save Changes publishes your edits immediately.

3. Site Configuration

What it controls: Contact details, currency, SEO settings, site name, and maintenance mode.

How to open it

1. Click "Site Config" in the left sidebar under Settings

Fields explained

Localisation

Changing this setting affects every place a price is displayed — the vehicle model hero banner and any price labels on the site. The available currencies are:

If you need a currency not in this list, ask your developer to add it to src/lib/currencies.ts — all other parts of the site pick it up automatically.

Contact Information

What is a hex color code? It is a # followed by 6 characters (letters A–F and numbers 0–9). You can find hex codes at htmlcolorcodes.com.

Site Identity

Maintenance Mode

Global WhatsApp Button

Controls the floating WhatsApp button shown across all public pages. See Section 3b for full instructions.

How to update Site Configuration

1. Click into any field and type the new value
2. Click Save Changes

3a. Cache Refresh

The Refresh Content Cache panel sits at the top of the Site Config page. Use it whenever uploaded images, logos, or other media are not appearing on the live website.

When to use it

How to refresh the cache

1. Click Site Config in the left sidebar
2. Find the Refresh Content Cache panel at the top of the page
3. Click the Refresh Cache button
4. Wait for the spinner to finish — this usually takes 5–15 seconds
5. A green confirmation message shows how many pages were refreshed (e.g. Cache cleared and 12/12 pages pre-warmed)
6. Reload the live website — the updated content should now appear

Note: The cache refreshes automatically when you click Save Changes on most pages. You only need to manually refresh if changes are not appearing after saving, or after uploading assets directly through Sanity Studio.

3b. Global WhatsApp Button

What it controls: A floating green WhatsApp button that appears in the bottom-right corner of every public page (except vehicle model pages). Visitors can tap it to open a WhatsApp conversation with a pre-filled message.

Fields explained

Number format tip: Do not use spaces, dashes, or brackets in the number — use digits only with a + country code prefix, e.g. +17215550100 not +1 (721) 555-0100.

Enabling the button

1. Open Site Config from the left sidebar
2. Scroll down to the Global WhatsApp Button section
3. Click the Disabled button — it turns green and reads Enabled
4. Optionally enter a custom WhatsApp number (leave blank to use the Contact Telephone number)
5. Optionally enter a custom pre-filled message (leave blank for the default message)
6. Click Save Changes

Disabling the button

1. Open Site Config
2. Scroll to Global WhatsApp Button
3. Click the Enabled button — it turns grey and reads Disabled
4. Click Save Changes

Where the button appears

The vehicle-specific WhatsApp button on each model page is separate and is not affected by this setting. It uses the vehicle model name in its message and is always active regardless of the global toggle.

4. Navigation

What it controls: The top navigation menu links visible on every page of the website.

How to open it

1. Click "Navigation" in the left sidebar under Settings

The navigation editor

You will see a list of your current nav items. Each row shows the link label and its URL.

Desktop

ModelsAbout CheryServiceTechnologyContact

Mobile

Home

Models

About Chery

Service

Technology

Contact

Adding a new nav item

1. Click "Add Nav Item" at the bottom of the list
2. Fill in the fields (see table below)
3. Click Save

Editing a nav item

1. Click "Edit" on the row you want to change
2. Update the fields in the dialog that opens
3. Click Save

Removing a nav item

1. Click the ✕ button on the right of the item
2. Click Save Changes to confirm

Reordering nav items

Click the ↑ or ↓ arrows on the left of each row to move it up or down. Click Save Changes when done.

Nav item fields explained

Adding child links

Each nav item can have sub-links that appear in mobile dropdowns and the desktop hover bar:

1. Click Edit on the parent nav item
2. In the dialog, scroll to the Children section
3. Click "Add Child" and fill in the same fields
4. Click Save

5. Home Page Banners

What it controls: The large hero images and videos that rotate on the home page, plus the main CTA (Call-to-Action) image.

How to open it

1. Click "Home Page Banners" in the left sidebar under Settings

The banner list

You will see a list of existing banners and an Add Banner button:

Desktop — 1920 × 1080 px / resolution 150 dpi

Mobile — 1000 x 1667 px / resolution 72 dpi

Adding a new banner

1. Click "Add Banner"
2. A dialog opens — fill in the fields (see table below)
3. Click Save
4. Click Save Changes on the main page to publish

Editing an existing banner

1. Click "Edit" on the banner row
2. Update the fields in the dialog
3. Click Save, then Save Changes

Removing a banner

1. Click the ✕ button on the banner row
2. Click Save Changes to confirm

Reordering banners

Banners display in the order shown in the list. Click the ↑ or ↓ arrows to move a banner, then click Save Changes.

Banner fields explained

Required fields

Image banner fields

Video banner fields

Optional styling fields

CTA Image

At the bottom of the Banners page there is a CTA Image section. This is the decorative photo shown in the Call-to-Action section on the home page. Click Replace image to upload a new one, then click Save Changes.

6. Vehicle Catalog

What it controls: Which vehicles appear on the website, in what order, and at what price.

Important: A vehicle must first be created in the Vehicles section before it can be added to the catalog.

How to open it

1. Click "Catalog" in the left sidebar under Settings

The catalog list

You will see a list of vehicles currently in the catalog, each showing the vehicle name and its price.

Adding a vehicle to the catalog

1. Click "Add Vehicle"
2. In the dialog, select the vehicle from the dropdown
3. Enter the Price (optional — leave empty to hide the price on the website)
4. Click Save, then Save Changes

Setting or updating a price

1. Click "Edit" on the vehicle row
2. Update the price field (numbers only — no currency symbol or commas)
3. Click Save, then Save Changes

The currency symbol shown next to the price (e.g. $, NAf., €) is controlled by the Currency setting in Site Config, not here.

Removing a vehicle from the catalog

1. Click the ✕ button on the vehicle row
2. Click Save Changes

Removing a vehicle from the catalog does not delete the vehicle. It only removes it from the website listing. You can re-add it at any time.

Reordering the catalog

The vehicles display on the website in the same order as this list. Click the ↑ or ↓ arrows to reorder, then click Save Changes.

Series grouping follows catalog order. The series tabs in the home page vehicle slider and the series sections in the mobile navigation menu are ordered by the first vehicle of each series that appears in this catalog list. For example, if the first Tiggo model appears before the first Himla model, the Tiggo series tab will appear first. To change the series order, move vehicles in the catalog so the desired series appears first.

7. Vehicles

What it controls: Full detail pages for each vehicle model — images, specs, performance data, interior, exterior gallery, banners, colors, and spec sheet downloads.

How to open it

1. Click "Vehicles" in the left sidebar under Content
2. You will see a table of all existing vehicles

The vehicles table

Creating a new vehicle

1. Click "New Vehicle" in the top-right of the page
2. A tabbed form opens — fill in the fields across all tabs
3. Click Save Vehicle when finished
4. Then go to the Catalog section to add the vehicle to the website listing

Editing an existing vehicle

1. Click the ✏ (edit) button on the vehicle row
2. The tabbed form opens with the existing data loaded
3. Edit the desired fields
4. Click Save Vehicle

Deleting a vehicle

⚠️ Warning: Deleting a vehicle is permanent and cannot be undone. First remove it from the Catalog, then delete it here.

1. Click the 🗑 (delete) button on the vehicle row
2. Confirm the deletion in the dialog that appears

Duplicating a vehicle

Use this when you need to create a new vehicle that is similar to an existing one — for example, adding a new trim level or annual refresh that shares most of the same content.

How to duplicate a vehicle:

1. In the Vehicles table, find the vehicle you want to copy
2. Click the ⧉ (copy) button on the right side of the row
3. A confirmation dialog appears — read the message and click Create Copy
4. The new vehicle appears at the top of the table with a modified slug (e.g. tiggo-9-copy-07)
5. Click ✏ Edit on the new vehicle to rename it and update any fields that differ
6. Once ready, go to the Catalog section to add it to the website listing

After duplicating: The copied vehicle is not visible on the website until you add it to the Catalog (Section 6). The slug is automatically set to avoid conflicts — update it in the Basics tab if needed (do this before adding to catalog, since the slug becomes the URL).

Vehicle form tabs

The vehicle form is split into tabs. Click each tab name to switch between sections.

Tab 1 — Basics

Identity and core images.

PDF tip: Only .pdf files are accepted. If your file is larger than 5 MB, compress it first at ilovepdf.com.

Tab 2 — Banners

Hero images and videos shown at the top of this vehicle's detail page. Works the same as Home Page Banners.

1. Click "Add Banner" to add a new hero slide
2. Fill in the fields (same as Home Page Banners — see Section 5)
3. Use the ↑↓ buttons to reorder banners
4. Click ✕ to remove a banner

Tab 3 — Performance

Data displayed in the Performance section of the vehicle page.

Appearance text

Performance figures

Drive Modes

Select which driving modes are available for this vehicle. Each mode appears as a labelled button — click to toggle it on (highlighted) or off. Only the selected modes are shown in the Drive Modes panel on the live vehicle page.

Tip: For most models enable ECO, NORMAL, and SPORT. Add SNOW, MUD, and OFF-ROAD only for AWD or off-road variants (e.g. Tiggo 8, Tiggo 9).

Tab 4 — Design

Side-profile image with interactive hotspot callouts and dimension information.

Appearance text

Main Design Image

Upload the side-profile image of the vehicle. Once uploaded, you can place hotspots directly on it by clicking the image — a numbered pin is placed at the exact point you click.

Adding a design hotspot

1. Upload the design image first
2. Click anywhere on the image to place a new hotspot at that position
3. An edit dialog opens automatically — fill in:
   • Title — e.g. Panoramic Sunroof
   • Description — text shown when the hotspot is clicked
   • Image — optional close-up photo of the feature
4. Click Save
5. Existing hotspots appear as numbered blue pins on the image — click Edit or ✕ to change or remove them

What you see is what visitors see. The editor image uses the same crop and zoom as the live vehicle page, so the pin positions you place here match exactly where they appear on the website.

Removing all hotspots at once

If you need to clear all hotspots and start fresh, click the Clear all button (shown in red next to "Add Hotspot" when at least one hotspot exists). A confirmation dialog will ask you to confirm before removing them all. Click Save Vehicle afterward to apply the change.

Dimensions (all measurements in millimetres)

Tab 5 — Interior & Safety

Appearance / Description Block

This controls the large text overlay that appears on the interior section of the vehicle page — the eyebrow label, the main heading, and an optional subtitle.

If you leave these fields empty, the vehicle page will use built-in fallback text.

Interior Image & Features

Adding an interior feature:

1. Click "Add Feature"
2. Enter the Label and Value
3. Repeat for each feature

Adding interior slider images:

1. Click "Add Slide"
2. Upload an image for that slide
3. Optionally fill in Alt Text (image description for accessibility) and Title (caption displayed on the slide)
4. Repeat for each slide
5. Use the ↑↓ arrows to reorder slides
6. Click ✕ to remove a slide

Safety

Safety Image: Upload the image for the Safety section of the vehicle page.

Safety Features: A text area for listing safety features.

Tab 6 — Colors

Assign which paint and interior trim options are available for this vehicle.

Exterior Colors

1. Click "Add Exterior Color"
2. Select from the dropdown (colors must already exist — see Section 9)
3. Click ✕ next to a color to remove it

Interior Colors

Same process as exterior colors.

If a color you need does not appear in the dropdown, go to Exterior Colors or Interior Colors to create it first.

8. Articles (News & Publications)

What it controls: The news section of the website. Each article can be categorised as News or a Publication.

How to open it

1. Click "Articles" in the left sidebar under Content

The articles table

Creating a new article

1. Click "New Article"
2. Fill in all required fields (marked ✅ below)
3. Write the content using the rich text editor
4. Click Save Article

Editing an article

1. Click the ✏ (edit) button on the article row
2. Make your changes
3. Click Save Article

Deleting an article

1. Open the article by clicking ✏
2. Scroll to the bottom and click Delete Article
3. Confirm the deletion

Article fields explained

Writing article content

The Content field uses a rich text editor with a toolbar:

Toolbar guide:

Toggling "Featured"

Click the star (☆/★) icon in the articles table to toggle featured status directly without opening the article.

9. Exterior Colors

What it controls: The available exterior paint color options that can be assigned to vehicle models.

How to open it

1. Click "Exterior Colors" in the left sidebar under Colors

The colors table

Adding a new color

1. Click "Add Color"
2. Fill in:
   • Name (required) — Color name shown on the website (e.g. Pearl White)
   • Hex Code (required) — 6-character color code starting with # (e.g. #FFFFFF)
3. Click Save

Finding a hex code: Use htmlcolorcodes.com to pick a color and copy the code. Or search online for the color name + "hex code".

Editing a color

1. Click "Edit" on the color row
2. Update the Name or Hex Code in the dialog
3. Click Save

Changes to a color name or swatch will update everywhere it appears across all vehicle pages.

Deleting a color

1. Click ✕ on the color row
2. Confirm the deletion

⚠️ First remove this color from all vehicles that use it, otherwise it will disappear from those vehicle pages.

10. Interior Colors

What it controls: The available interior color and trim options for vehicle models.

The process is identical to Section 9 — Exterior Colors:

1. Click "Interior Colors" in the left sidebar
2. Click "Add Color" to create a new option
3. Enter the Name (e.g. Black Leather) and Hex Code (e.g. #1A1A1A)
4. Click Save

Interior colors are assigned to vehicles in the Colors tab of the vehicle form.

11. About Us

What it controls: The content of the About Chery page on the website — main image and body text.

How to open it

1. Click "About Us" in the left sidebar under Settings

Editing the content

The About Us page has two sections:

Content (Rich Text)

Edit the page text using the rich text editor. The toolbar works the same as the Article editor — see Section 8 for the toolbar guide.

Desktop layout

Mobile layout

• Click the upload area (or "Replace image") to upload a new photo
• Click ✕ on the image to remove it

Click Save Changes when finished.

12. Warranty Page

What it controls: All content on the warranty page — the hero banner, the warranty coverage cards, and the partner logos.

How to open it

1. Click "Warranty Page" in the left sidebar under Settings

Hero Section

Leave the background image empty for a plain-color background.

Warranty Items

Each entry produces one coverage card on the page.

Adding a new warranty type:

1. Click "Add Warranty Item"
2. Fill in the fields:

1. Click Save, then Save Changes

Editing a warranty item:

1. Click "Edit" on the item row
2. Update the fields
3. Click Save, then Save Changes

Removing a warranty item:

1. Click ✕ on the item row
2. Click Save Changes

Reordering warranty items:

Click the ↑ or ↓ buttons to move items up or down, then click Save Changes.

Our Partners

Each entry produces one partner logo tile in the grid.

Adding a partner logo:

1. Click "Add Partner"
2. Fill in:

1. Click Save, then Save Changes

Removing a partner:

1. Click ✕ on the partner row
2. Click Save Changes

13. Tips & Common Tasks

How to upload an image

Every image field works the same way:

1. Click the upload area or "Click to upload image" button
2. Either:
   • Click "Browse files" and select a file from your computer, or
   • Drag and drop the image file onto the upload area
3. Wait for the upload to complete (a progress bar is shown)
4. After uploading, the image preview is displayed

• Click ✕ to remove the image
• Click "Replace image" to swap it with a different file
• Accepted formats: JPG, PNG, WEBP, GIF

How to generate a slug

The Slug is the URL-friendly version of a title (e.g. the slug for "Tiggo 9" is tiggo-9).

• Slugs are auto-generated when you enter a title — you do not need to type them
• Click "Generate" next to the slug field if it does not auto-fill
• Do not edit slugs after a page is live — changing a slug changes the URL, which breaks existing links and bookmarks

How to find a hex color code

A hex color code is a # followed by 6 characters, e.g. #BE8751.

• Go to htmlcolorcodes.com and use the color picker
• Or search online: pearl white hex code

How to quickly check what is on the website

The Dashboard (click "Dashboard" in the sidebar) shows:

• Total article count and featured article count
• Total vehicle count
• Color counts
• Recent articles and vehicles
• Login activity for the last 7 days

14. Sync

The Sync page lets you copy all published content from this project (the source) to one or more other Sanity projects (destinations). This is useful for keeping a staging site, a regional copy, or any connected project up to date without manual exports or developer involvement.

Where to find it

Click Sync under the Tools section in the sidebar.

What you see on the page

Source card — shows the project ID and dataset this admin panel is connected to, the total number of published documents, and a breakdown by content type.

Destination cards — one card per connected destination. Each card shows:

Syncing content

Sync a single destination

1. Find the destination card you want to update
2. Click Sync Now
3. A progress indicator appears below the button showing the current phase (e.g. Checking assets…, Uploading assets 3/12, Writing documents 45/142)
4. When complete, the button area shows how many documents were synced (e.g. 142 synced) or lists any errors

Sync all destinations at once

Click the Sync All button in the top-right of the page. This runs a sync to every configured destination in sequence and shows a summary when done.

What gets synced

• All published documents (drafts are never synced)
• Images and files — any image or file assets referenced by your documents are copied to the destination project first, before the documents are written
• Content types in the Whitelist (if configured for a destination) — when a whitelist is set, only those types are synced; all others are skipped for that destination

The following internal types are always excluded:

• Analytics events
• System documents (system.group, system.retention)
• Raw asset records (sanity.imageAsset, sanity.fileAsset) — assets are re-uploaded rather than copied as raw records

Reading the progress bar

While a sync is running, a small progress bar appears under the Sync Now button:

The sync happens in two phases:

1. Assets — images and files are uploaded to the destination (skipped if already present)
2. Documents — all content documents are written to the destination

After syncing

• The destination card badges and counts refresh automatically after each sync without needing a full page reload
• If the sync shows errors, an error log expands below the button listing the affected document IDs and the reason each failed
• Only documents that are new or have changed content are written — if everything is already identical, the sync completes instantly with nothing written

Errors

Note: The Sync page is a Tools feature intended for administrators. Content managers do not need to use it during normal day-to-day work.

15. Troubleshooting

The Save Changes button is greyed out

There are no unsaved changes — your content is already up to date.

An error message appears after clicking Save Changes

My changes are not showing on the website

1. Make sure you clicked Save Changes (not just edited the form)
2. Vehicle and content pages are cached for fast loading. After saving, the cache is automatically cleared — changes typically appear within a few seconds.
3. Hard-refresh your browser: Ctrl + Shift + R (Windows) or Cmd + Shift + R (Mac)
4. If the change still does not appear after 30 seconds, contact your system administrator — the automatic cache update (webhook) may not be configured correctly.

I cannot log in

• Check that Caps Lock is off
• Click "Forgot password?" on the login page to reset your password
• Contact your system administrator if the issue persists

A color I created is not appearing in the vehicle color dropdown

Colors must be created and saved before they appear in the vehicle form dropdowns. Go to Exterior Colors or Interior Colors, create the color, then return to the vehicle form.

I accidentally deleted something

Contact your system administrator as soon as possible. Sanity keeps a history of all content — deleted items can often be recovered within a short period.

16. Transactional Emails

The website sends automated emails in response to visitor actions — contact form submissions, service requests, vehicle inquiries, and dealer onboarding submissions. This section describes each email, who receives it, and what information it contains.

All emails share the same visual style: a blue header, gold-accented section titles, and a light footer. The active email provider (Resend, SMTP, or Mailgun) is configured in the server environment and is transparent to the templates — the emails look and behave the same regardless of provider.

Note: Email delivery requires the EMAIL_PROVIDER environment variable and the corresponding API key to be configured by your system administrator.

Contact Form Email

Sent when a visitor submits the Contact Us form found on the main contact page.

Received by: The contact email address configured in CONTACT_EMAIL, with copies sent to the admin email (ADMIN_EMAIL) and any sales CC addresses (NEXT_PUBLIC_SALES_EMAIL_CCS).

Reply-to: Automatically set to the visitor's email address — replying to the email opens a reply directly to the visitor.

Service Request Email

Sent when a visitor submits the Service Request form.

Received by: The service department email address configured in NEXT_PUBLIC_SERVICE_EMAIL, with a copy sent to the admin email (ADMIN_EMAIL).

Reply-to: Automatically set to the visitor's email address.

Model Inquiry Email

Sent when a visitor submits the contact form on a vehicle model page (e.g. the Tiggo 9 page).

Received by: The contact email address (CONTACT_EMAIL), with copies to the admin email and any sales CC addresses.

Reply-to: Automatically set to the visitor's email address.

This email includes a Vehicle of Interest section at the bottom containing the vehicle's hero image, model name, price (if pricing is enabled), and direct links to the model page and spec sheet PDF.

Model Inquiry Confirmation Email

Sent automatically to the visitor immediately after they submit a model inquiry. This confirms their submission was received and gives them a reference of what they sent.

Received by: The visitor who submitted the form (their email address from the form).

This email is sent in addition to the admin notification — both emails are sent at the same time when the form is submitted.

17. GDPR & Cookie Consent

Manage cookie consent banner settings for the site. Changes stored in Sanity and take effect on the next page load for new visitors.

Admin location: Admin Panel → Settings → GDPR & Cookies (/admin/gdpr)

Consent Banner

Company name shown in the banner is pulled from Site Config → Company Name — update it there.

Cookie Categories

Controls which optional categories appear in the Cookie Preferences modal.

Toggle Analytics and Marketing on or off from the admin panel. The other two categories are always present in the modal.

Turning off a category in the admin hides it from the modal entirely — visitors can no longer opt in to that category.

How Consent Works

1. First visit — banner appears at the bottom of the screen with three equal-weight buttons: Reject All, Cookie Settings, Accept All.
2. Cookie Settings — opens the preferences modal where visitors can toggle individual categories.
3. Consent stored — choice is saved to localStorage (chery-consent) and a first-party session cookie (chery-consent-given).
4. Version mismatch — if the stored consent version differs from the current policy version, the banner reappears and the visitor must consent again.
5. Google Analytics — only loads after the visitor consents to the Analytics category.

Privacy Policy Page

A full privacy policy page lives at /privacy-policy. It includes:

• Detailed explanation of all cookie categories and what they track
• A cookie table listing specific cookies set by the site
• An inline Cookie Settings button that opens the preferences modal directly from the page

The page content is hardcoded in src/app/privacy-policy/PrivacyPolicySections.tsx. Update that file to reflect any changes to your actual cookie or data processing practices.

Last updated: May 2026 — added GDPR & Cookie Consent section (17), Global WhatsApp Button (3b), Cache Refresh (3a), Vehicle Duplicate, Interior & Safety Appearance Block, and updated Table of Contents