WordPress Client Onboarding Kit
A complete, ready-to-customize documentation package for handing off WordPress sites to clients. Covers CMS training, content editing, user roles, event management, analytics, and marketing campaigns. Built from real client handoff experience.
1. Who This Kit Is For
If you build WordPress websites for clients, you know the hardest part is not the build -- it is the handoff. Clients call you two weeks later because they cannot figure out how to change a phone number. They accidentally delete a page. They do not understand why their Google Analytics shows zero traffic.
This kit solves that problem. It is a complete documentation package you can customize with your client's specific site details, hand over at launch, and reference every time they have a question. It saves you hours of support calls and makes you look more professional.
Customize the highlighted fields with your client's specific details.
2. Dashboard Orientation
Your WordPress Dashboard
Your website runs on WordPress, the same platform that powers 43% of all websites on the internet. You will manage everything through the Dashboard, which you access by going to:
https://yoursite.com/wp-admin
Log in with the credentials we provided. Once logged in, you will see the Dashboard home screen with these key areas:
- Posts: Blog articles, news, and updates. These appear on your blog page and are organized by date.
- Pages: Static pages like Home, About, Services, Contact. These do not change frequently.
- Media: Your image and file library. Every photo, PDF, or video you upload lives here.
- Appearance: Theme settings, menus, and widgets. Do not change these without consulting your developer.
- Plugins: Extensions that add features to your site. Do not install, update, or delete plugins yourself.
- Settings: Site title, tagline, and general configuration. Do not change these.
The left sidebar is your main navigation. Everything you need is there.
3. User Roles and Permissions
WordPress User Roles
WordPress has five user roles. Each role has different permissions:
- Administrator: Full access to everything. Your developer has this role. You should have exactly one admin account for your business. Do not create additional admin accounts.
- Editor: Can create, edit, publish, and delete any post or page -- including other people's content. Good for a content manager or marketing lead.
- Author: Can create, edit, and publish their own posts only. Cannot edit other people's content. Good for blog contributors.
- Contributor: Can write and edit their own posts, but cannot publish them. Posts go to "Pending Review" status for an Editor or Admin to approve.
- Subscriber: Can only log in and manage their own profile. No content access. Used for membership features.
Your team's roles:
- Name — Administrator (primary site owner)
- Name — Editor (content manager)
- Developer Name / Agency — Administrator (technical support)
To add a new user: go to Users > Add New. Enter their email, assign them the Author or Contributor role (never Administrator), and click "Add New User." They will receive an email to set their password.
4. Content Editing Guide
Editing Existing Content
To edit any page or post:
- Log in to your Dashboard.
- Go to Pages (for static pages) or Posts (for blog articles).
- Hover over the page or post you want to edit. Click "Edit".
- Make your changes in the editor. The editor uses blocks -- each paragraph, image, heading, or button is a separate block you can click and edit.
- Click "Update" (top right) to save and publish your changes immediately.
Creating New Content
- Go to Posts > Add New (for a blog article) or Pages > Add New (for a static page).
- Enter your title at the top.
- Start typing your content. Press Enter to create new paragraph blocks.
- To add an image, click the "+" button and select "Image." Upload from your computer or choose from the Media Library.
- To add a heading, click "+" and select "Heading." Use Heading 2 (H2) for main sections and Heading 3 (H3) for subsections. Never use Heading 1 -- that is reserved for the page title.
- Set a Featured Image in the right sidebar. This is the image that appears in previews, social media shares, and search results.
- Set the Category and Tags in the right sidebar.
- Click "Publish" to go live, or "Save Draft" to save without publishing.
Content Best Practices
- Keep paragraphs short -- 2 to 3 sentences maximum.
- Use headings to break up long content. Readers scan before they read.
- Every blog post should be at least 300 words for SEO purposes. 800-1,200 words is ideal.
- Include at least one image per post. Name image files descriptively before uploading (e.g., "team-photo-july-2026.jpg" not "IMG_4523.jpg").
- Fill in the Excerpt field (right sidebar) with a 1-2 sentence summary. This appears in search results and post listings.
- Check "Preview" before publishing to see how it will look to visitors.
5. Media and Image Management
Working with Images
All images and files you upload go to the Media Library (left sidebar > Media).
- Image size: Resize images to 1200px wide maximum before uploading. Large images slow down your site. Use a free tool like squoosh.app to compress images.
- File format: Use JPEG (.jpg) for photographs and PNG (.png) for graphics with transparency (logos, icons). Use WebP when possible for best performance.
- File naming: Name files descriptively before uploading. WordPress uses the filename as the default alt text, which matters for SEO and accessibility.
- Alt text: Always fill in the "Alt Text" field when uploading an image. Describe what the image shows in a short phrase: "Team installing new roof on residential home" -- not "photo" or "image1."
- Do not delete images from the Media Library unless you are certain they are not used anywhere on the site. Deleting an image that is embedded in a page will leave a broken image placeholder.
Uploading Files (PDFs, Documents)
You can upload PDFs, Word documents, and other files through Media > Add New. To link to a file from a page or post, upload it first, copy the file URL from the Media Library, then create a link in your content.
6. Event and Calendar Management
Managing Events
Skip this section if your site does not have an events feature.
If your site uses an events plugin (such as The Events Calendar, Events Manager, or a custom events post type), managing events works similarly to managing posts:
- Go to Events in the left sidebar.
- Click "Add New" to create an event.
- Fill in the event title, description, date, time, and location.
- Set a Featured Image for the event (this appears on the calendar and event listings).
- Set the event Category (e.g., Workshop, Fundraiser, Meeting).
- Click "Publish" to make the event visible on your site's calendar.
Recurring events: If the plugin supports it, use the "Recurrence" option instead of creating the same event multiple times. This keeps your calendar clean and makes it easy to update all instances at once.
Past events: Most event plugins automatically move past events off the main calendar view. You do not need to delete them -- they serve as an archive and help with SEO.
7. Google Analytics Walkthrough
Accessing Your Analytics
Your site has Google Analytics installed. This tells you how many people visit your site, where they come from, and what they do. To access it:
- Go to analytics.google.com.
- Log in with the Google account: analytics-email@gmail.com
- Select your property: Your Site Name
Key Reports to Check Monthly
- Realtime: Shows who is on your site right now. Fun to watch during a marketing push, but not actionable for strategy.
- Acquisition > Overview: Where your traffic comes from -- organic search (Google), direct (typed URL or bookmarks), social media, referrals (links from other sites), or paid ads. This tells you which marketing channels are working.
- Engagement > Pages and Screens: Which pages get the most views. If your Services page gets 10x the views of your About page, invest more in your Services content.
- Engagement > Landing Pages: The first page people see when they arrive. If your blog post is the top landing page, your SEO is working. If it is always the Home page, you need more content.
- User Attributes > Demographics: Age, gender, location, and interests of your visitors. Use this to validate that you are reaching your target audience.
What the Numbers Mean
- Users: Unique visitors (one person visiting 5 times = 1 user).
- Sessions: Total visits (one person visiting 5 times = 5 sessions).
- Pageviews: Total pages viewed (one visit viewing 3 pages = 3 pageviews).
- Avg. Engagement Time: How long people actively interact with your site. Under 30 seconds is a red flag -- it means people leave quickly.
- Bounce Rate: Percentage of visitors who leave after viewing only one page. High bounce rate on a blog post is normal. High bounce rate on your Home page is a problem.
8. Marketing Campaign Framework
How to Track a Marketing Campaign
When you run a promotion, event, or advertising campaign, you want to know if it drove traffic to your website. Google Analytics can track this using UTM parameters -- special tags you add to your URLs.
Step-by-Step: Creating a Tracked Campaign Link
- Go to Google's Campaign URL Builder.
- Enter your website URL: https://yoursite.com
- Fill in three required fields:
- Campaign Source: Where the link will be posted (e.g., "facebook", "newsletter", "flyer")
- Campaign Medium: The type of marketing (e.g., "social", "email", "print", "cpc")
- Campaign Name: A name for this specific campaign (e.g., "summer-sale-2026", "grand-opening")
- Copy the generated URL. It will look like:
https://yoursite.com/?utm_source=facebook&utm_medium=social&utm_campaign=summer-sale-2026 - Use this link in your Facebook post, email newsletter, or printed QR code -- not your regular URL.
Viewing Campaign Results
In Google Analytics, go to Acquisition > Traffic Acquisition and filter by "Session campaign" to see how many visits each campaign generated. You can also see which campaign visitors stayed longest, viewed the most pages, and converted.
Scenario: You are promoting a summer adoption event on Facebook, Instagram, and an email newsletter.
Create three separate tracked URLs -- one for each channel. All three use the same Campaign Name ("summer-adoption-2026") but different Sources ("facebook", "instagram", "mailchimp"). After the event, check Analytics to see which channel drove the most visitors and which visitors stayed longest on your site.
9. Ongoing Maintenance Checklist
- Weekly: Publish at least one blog post or news update. Fresh content signals to Google that your site is active.
- Weekly: Check for and respond to contact form submissions and comments.
- Monthly: Review Google Analytics (see Section 7). Note trends in traffic, top pages, and referral sources.
- Monthly: Check that all pages load correctly. Click through your menu and test key links.
- Monthly: Back up your site. Your hosting provider may do this automatically, but verify.
- Quarterly: Review and refresh outdated content. Update hours, pricing, team bios, and any seasonal information.
- Quarterly: Check Google Search Console for crawl errors, security issues, or indexing problems.
- As needed: Contact your developer for plugin updates, WordPress core updates, theme changes, or any technical issues. Do not attempt these yourself.
10. Client Handoff Checklist
Use this checklist when delivering a completed WordPress site to a client. Every item should be complete before the handoff meeting.
- Client admin account created with strong password
- All user roles assigned (admin, editors, authors)
- Login URL and credentials documented and delivered securely
- Google Analytics installed and tracking confirmed
- Google Search Console verified and sitemap submitted
- Contact form tested (send a test submission, verify email delivery)
- All pages reviewed for placeholder content (lorem ipsum, stock photos)
- SSL certificate active (site loads with https://)
- Favicon and site title set correctly
- Social media meta tags configured (Open Graph, Twitter Cards)
- Backup system configured and first backup completed
- This onboarding document customized and delivered to client
- 30-minute walkthrough call scheduled with client
- Support contact and response time expectations documented
Need Help With Your WordPress Build?
We build and hand off WordPress sites with complete client documentation. No more support calls about how to change a phone number.
Get in Touch