Client Training Guide
Document ID: WBL-DEL-TG-[ID]-v1.0 Project: [PROJECT NAME] Client: [CLIENT NAME] System(s) Covered: [CMS / Automation Platform / Website] Trainer: [PM / Developer NAME] Training Date(s): [DATE(S)] Training Format: ☐ Live (video call) ☐ In-person ☐ Recorded walkthrough ☐ Self-paced (this guide only) Recording Link (if applicable): [URL]
Purpose: This guide serves as the operational reference manual for [CLIENT NAME]'s team to manage, update, and maintain the [system(s)] delivered under this project. Keep it accessible. Update the relevant sections if your setup changes.
If you get stuck: Contact your Webility Project Lead at [PM EMAIL] or [SUPPORT EMAIL]. For urgent issues (site down, automation stopped), use the emergency contact in Section 8.
Part 1 — Getting Started
1.1 What Was Built
This project delivered the following systems that your team will manage:
| System | Platform | Purpose | Your Access Level |
|---|---|---|---|
| [Website / CMS] | [WordPress / Webflow / Next.js + Sanity / etc.] | Content management and website updates | [Admin / Editor / Author] |
| [Automation Workflow] | [n8n / Make / Zapier] | [Brief description of what it automates] | [Admin / View only] |
| [E-commerce] | [Shopify / WooCommerce] | [Products, orders, inventory] | [Admin] |
| [Analytics Dashboard] | [Google Analytics 4 / Looker Studio] | Traffic and conversion reporting | [Viewer / Editor] |
| [Other] |
1.2 Your Team's Access
The following users have been configured with access to each system:
| Name | Role | System(s) | Access Level | Email Used |
|---|---|---|---|---|
| [Name 1] | [Title] | [System] | Admin | [email] |
| [Name 2] | [Title] | [System] | Editor | [email] |
| [Name 3] | [Title] | [System] | Viewer | [email] |
To add or remove users: [Instruction for this specific platform — e.g., "Go to Settings > Users > Invite User" or "Contact Webility to add/remove admin-level accounts."]
Security reminder: Never share your login credentials with others. Each team member should have their own account.
1.3 Accessing Your Systems
| System | URL | Login Method |
|---|---|---|
| Website CMS / Admin | [URL] | Email + password (+ 2FA — see note below) |
| Automation Platform | [URL] | [Login method] |
| Hosting Dashboard | [URL] | [Login method] |
| Analytics | [URL] | Google Account |
| [Other] |
Two-factor authentication (2FA): [Instruction — e.g., "2FA is enabled on your CMS admin. You will need your authenticator app (Google Authenticator / Authy) to log in. Backup codes were shared with your Account Director at handover."]
Part 2 — Website Content Management
(Complete this section for CMS-based sites. If this project did not include a CMS, mark N/A.)
2.1 CMS Overview
Your website uses [CMS NAME] ([version if applicable]) as the content management system.
What you can do yourself:
- Update page text, headings, and descriptions
- Add, edit, and delete blog posts or news articles
- Upload and manage images and files
- Update team member profiles
- Update service descriptions
- Manage navigation menus (with caution — see note in Section 2.6)
What requires a developer (do not attempt yourself):
- Changing the site's visual design or layout
- Installing or updating plugins/themes (unless you have a Maintenance Plan covering this)
- Editing PHP / JavaScript / CSS files directly
- Changing DNS settings or hosting configuration
- Installing new plugins without approval
2.2 Logging In
- Go to [ADMIN URL]
- Enter your email: [email]
- Enter your password (stored in your password manager)
- Complete 2FA if prompted
- You will land on the Dashboard
Forgot your password? Use the "Lost your password?" link on the login page — reset email will arrive within a few minutes. Check spam if not received.
2.3 Editing a Page
Step-by-step:
- From the Dashboard, go to [Pages / Content / Collections] in the left sidebar
- Find the page you want to edit — you can search by name
- Click the page title to open the editor
- Make your changes in the content editor (see Section 2.4 for editor tips)
- Click [Save Draft] if you want to save without publishing, or [Update / Publish] to make it live immediately
- Preview your changes using the [Preview] button before publishing
Important: Changes published using Update are immediately live on your website. There is no staging buffer unless your plan includes it.
2.4 Using the Content Editor
Your site uses [Block Editor / Gutenberg / WYSIWYG / Sanity Studio / Contentful / etc.].
Formatting basics:
- Bold: Ctrl+B (Windows) / Cmd+B (Mac), or select text and click Bold button
- Italic: Ctrl+I / Cmd+I
- Headings: Use the paragraph dropdown to select H2, H3, etc. (do not use H1 — that is the page title)
- Links: Select text → click the link icon → paste URL. For external links, check "Open in new tab."
- Lists: Bullet list and numbered list buttons are in the toolbar
Adding images:
- Click the [Add Media / Insert Image / Upload] button
- Upload a new image or select from the media library
- Always fill in the Alt Text field (describes the image for accessibility and SEO)
- Choose the appropriate size variant — do not upload images larger than 2MB
Images should be:
- Maximum 2000px wide for full-width images
- Saved as JPG (photographs), PNG (graphics/logos), or WebP (preferred for performance)
- Under 500KB wherever possible (use squoosh.app to compress before uploading)
2.5 Managing Blog / News Posts
To create a new post:
- Go to Posts / Blog / News in the sidebar
- Click Add New
- Add a title, content, featured image, and excerpt
- Select the appropriate categories and tags
- Set the publish date (publish immediately or schedule for later)
- Click Publish
Best practices for blog posts:
- Title: 50–60 characters for best display in search results
- Excerpt: 150–160 characters (used as meta description if not set separately)
- Featured image: at minimum 1200 × 630px (for social sharing)
- Add an Alt Text to the featured image
To edit or unpublish an existing post: Find the post in the Posts list → click the title → make changes → click Update. To unpublish: change Status from "Published" to "Draft."
2.6 Menus and Navigation
Navigation menus can be edited, but proceed carefully. Changing a menu incorrectly can break navigation for all visitors.
To edit a menu (WordPress):
- Go to Appearance → Menus
- Select the menu you want to edit from the dropdown
- Add pages from the left panel or drag-and-drop to reorder
- Do not delete menu locations or create new menus — contact Webility if you need structural navigation changes
- Click Save Menu
If in doubt: Ask Webility to make navigation changes on your behalf under your Maintenance Plan.
2.7 Managing Media (Images, Files, PDFs)
All uploaded files are stored in your Media Library ([Media / Assets / Files] in the sidebar).
- You can upload images, PDFs, documents, and other files
- Files you upload will have their own URL — you can link to them directly
- Do not delete files that are already in use on pages — this will create broken images/links
- If you want to replace an image, upload the new one and update the reference on the page; then optionally delete the old one from the media library
2.8 Team / Staff Profiles
[Describe specifically how the client manages this for their site — e.g., "Team members are managed as a Custom Post Type called 'Team'. Go to Team → All Members to edit existing profiles or Add New to add a new member."]
Fields for each team member:
- Name (used as the page title)
- Job Title
- Bio
- Headshot photo (square, minimum 400×400px, professional)
- LinkedIn URL (optional)
- Email (optional)
Part 3 — Managing Your Automation System
(Complete this section for AI automation projects. Mark N/A if not applicable.)
3.1 System Overview
Your automation system processes the following:
| Workflow Name | Trigger | What It Does | Where to Monitor |
|---|---|---|---|
| [Workflow 1 name] | [e.g., New form submission] | [Plain-language description] | [n8n dashboard / Make history] |
| [Workflow 2 name] | [e.g., Every day at 9am] | ||
| [Workflow 3 name] |
3.2 Accessing the Automation Dashboard
- Go to [PLATFORM URL]
- Log in with [credential instructions]
- You will see your active workflows
- Green = active; Red = inactive; Orange = error
3.3 Monitoring for Errors
How to check if a workflow ran correctly:
- Click on the workflow name
- Click [Execution History / History / Runs] tab
- Green checkmarks = successful runs
- Red X marks = failed runs — click to see the error message
- Forward error details to Webility if you cannot resolve them
Common errors and what to do:
| Error Type | Likely Cause | Action |
|---|---|---|
| Authentication error | API key expired or revoked | Contact Webility — key needs rotation |
| Timeout error | External service was slow | Usually self-resolving; contact Webility if recurring |
| Data error | Unexpected input format | Contact Webility with an example of the problematic input |
| Rate limit error | Too many requests to an API | Contact Webility to adjust throttling |
3.4 What You Should NOT Change
The following changes to your automation system require Webility's involvement:
- Changing API keys or connection credentials
- Adding new nodes/steps to a workflow
- Modifying field mappings
- Changing trigger conditions
- Connecting new third-party services
- Anything in the [System Settings] area
Making unauthorized changes to automation workflows can cause data loss, duplicate processing, or missed records. If you need a change, submit a support request.
3.5 Human Review Steps (if applicable)
The following steps in your automation require a human decision before continuing:
| Workflow | Review Step | What to Review | How to Approve / Reject |
|---|---|---|---|
| [Workflow name] | [e.g., AI-drafted email review] | [What needs reviewing] | [Click Approve in [location] / Reply to notification email] |
Never approve without reviewing — the automation cannot verify the content is accurate for your business.
Part 4 — E-Commerce Management
(Complete this section for e-commerce projects. Mark N/A if not applicable.)
4.1 Managing Products
[Specific instructions for the client's platform — Shopify, WooCommerce, etc.]
To add a new product:
- [Step 1]
- [Step 2] ...
Key fields to complete for every product:
- Product title and description
- Price (and sale price if applicable)
- SKU / product code
- Stock quantity (enable inventory tracking)
- Product images (minimum 1000×1000px, white or transparent background preferred)
- Product category
- SEO title and description (if your platform has a separate SEO section)
4.2 Managing Orders
[Describe order management workflow specific to their platform.]
4.3 Discount Codes
[Describe how to create and manage discount codes.]
Part 5 — Analytics & Reporting
5.1 Accessing Google Analytics 4
- Go to analytics.google.com
- Sign in with [email address]
- Select property: [PROPERTY NAME]
Key reports to bookmark:
| Report | Location in GA4 | What It Shows |
|---|---|---|
| Website overview | Reports → Life cycle → Acquisition | Sessions, users, traffic sources |
| Top pages | Reports → Engagement → Pages and screens | Most visited pages |
| Conversions | Reports → Life cycle → Engagement → Conversions | Form submissions, purchases, etc. |
| Real-time | Reports → Real-time | Live visitor activity |
5.2 Understanding Your Key Metrics
| Metric | What It Means | Healthy Range (your site) |
|---|---|---|
| Sessions | Visits to your website | [Set baseline post-launch] |
| Users | Unique visitors | |
| Bounce rate / Engagement rate | % of visits where only one page was viewed (or engaged) | 40–60% bounce is typical |
| Average session duration | How long visitors stay | 1–3 minutes typical |
| Conversion rate | % of visitors who complete a goal (form submission, purchase, etc.) | Set target at launch |
| [Primary conversion event] | [Specific to this client] |
Part 6 — Routine Maintenance Tasks
These are tasks your team is responsible for on a regular basis. If you have a Webility Maintenance Plan, some or all of these may be managed by us — confirm with your PM.
| Task | Frequency | Who Does It | Notes |
|---|---|---|---|
| Review analytics for anomalies | Weekly | [Client team] | Flag if traffic drops >20% week-over-week |
| Check automation error log | Weekly | [Client team] | Forward unresolved errors to Webility |
| Renew domain registration | Annual (before expiry) | [Client — domain registrar] | Set calendar reminder 60 days before expiry |
| Review contact form spam | Weekly | [Client team] | Adjust spam settings if needed |
| Update written content (blog, news) | [Per your content calendar] | [Client team] | |
| Review and act on new form submissions | Daily | [Client team] | |
| Rotate API keys (for automation) | Annually or if compromised | Webility (notify Webility to coordinate) |
Managed by Webility (if on a Maintenance Plan):
| Task | Frequency | Plan Level Required |
|---|---|---|
| CMS core updates | Monthly | Starter+ |
| Plugin/theme updates | Monthly | Starter+ |
| Security scans | Monthly | Professional+ |
| Backup verification | Monthly | All plans |
| Performance audit | Quarterly | Business+ |
Part 7 — Common Tasks Reference
| Task | Where to Do It | Section Reference |
|---|---|---|
| Update homepage headline | CMS → Pages → Home | Section 2.3 |
| Add a blog post | CMS → Posts → Add New | Section 2.5 |
| Upload a new team photo | CMS → Team → [Member name] | Section 2.8 |
| Upload a PDF / brochure | CMS → Media → Add New, then link from page | Section 2.7 |
| Update contact information | CMS → [Contact page / Site Settings] | Section 2.3 |
| Update navigation menu | CMS → Appearance → Menus | Section 2.6 |
| Check automation status | [Platform URL] → Executions | Section 3.2 |
| View website traffic | analytics.google.com | Section 5.1 |
| Report a bug | Email [SUPPORT EMAIL] with screenshot | Section 8.2 |
Part 8 — Support & Escalation
8.1 Warranty Period
Your project includes a [30]-day warranty period beginning on [LAUNCH DATE] and ending on [DATE + 30 DAYS].
During this period, Webility will fix verified bugs attributable to our work at no charge.
What the warranty covers:
- Functionality that was working at launch and has since broken without any client changes
- Display issues not present at the time of launch sign-off
- Integration errors originating in Webility's configuration
What the warranty does not cover:
- New feature requests
- Issues caused by client changes to content, code, or settings
- Third-party platform changes (plugin updates, API changes by external providers)
- Issues introduced by unauthorized access to the hosting environment
- Content-related issues (broken links you create by updating content)
8.2 How to Report an Issue
To report a warranty or support issue:
- Email: [SUPPORT EMAIL]
- Subject line:
[CLIENT NAME] — [SITE NAME] — [Brief description] - Include:
- URL of the affected page
- What you expected to happen
- What actually happened
- Browser and device (e.g., Chrome on iPhone 15)
- Screenshot or screen recording if possible
- Steps to reproduce the issue
Response times during warranty:
| Priority | Description | Response | Resolution Target |
|---|---|---|---|
| P1 — Critical | Site is down or completely broken | Within 2 hours | 4 hours |
| P2 — High | Major feature broken (forms not working, checkout broken) | Within 4 hours | 1 business day |
| P3 — Medium | Important but not blocking (visual issue, broken link) | Within 1 business day | 2–3 business days |
| P4 — Low | Minor cosmetic issue | Within 2 business days | Within 5 business days |
8.3 After the Warranty Period
After [DATE], support requests are handled under your [Maintenance Plan / Ad-hoc support at [RATE]/hour].
To purchase a Maintenance Plan or request support after warranty expiry, contact [PM EMAIL].
8.4 Emergency Contact
For P1 emergencies (site completely down):
[PM NAME]: [PHONE / WhatsApp] — available [HOURS, TIMEZONE] Emergency support line: [PHONE / EMAIL] — for critical incidents outside business hours
Part 9 — Training Completion Record
Attendees
| Name | Title | System(s) Trained On | Signature |
|---|---|---|---|
Training Sign-Off
I/We confirm that:
- The systems described in this guide have been demonstrated to our team
- We have had the opportunity to ask questions and practice key tasks
- We understand how to access support during and after the warranty period
- We have received or can access the recording of the training session (if applicable)
Client Training Recipient:
Name: ___________________________ Title: ___________________________ Signature: ___________________________ Date: ___________________________
Webility Trainer:
Name: ___________________________ Signature: ___________________________ Date: ___________________________
Appendix A — Credentials Reference
(Do not store actual passwords here. This table references where credentials are stored.)
| System | Username / Email | Password Location | 2FA Method |
|---|---|---|---|
| CMS Admin | [Client password manager / 1Password vault] | Authenticator app | |
| Hosting Dashboard | [Client password manager] | ||
| Automation Platform | [Client password manager] | ||
| Analytics (Google) | Client's Google account | ||
| Domain Registrar | [Client password manager] |
Appendix B — Useful Resources
| Resource | URL | Purpose |
|---|---|---|
| [CMS platform documentation] | [official docs URL] | In-depth CMS reference |
| Google Analytics Help | [support.google.com/analytics] | GA4 documentation |
| Image compression | squoosh.app | Compress images before uploading |
| Color contrast checker | webaim.org/resources/contrastchecker | Check color accessibility |
| Webility client portal | [URL if applicable] | Project history, file storage |
Webility — WBL-DEL-TG-[ID]-v1.0 | Client Training Guide Confidential — for [CLIENT NAME] authorized personnel only.