WordPress.org
Get WordPress
WordPress.org

Make WordPress Training

WordPress Activity Kits

WordPress Activity Kits

In this article

↑ Back to top

A WordPress activity kit is a complete, ready-to-run resource that any WordPress event organizer, facilitator, or educator can download and use without needing to prepare their own session materials. Each kit contains four files:

  • A facilitator guide (.docx and .pdf) — covering learning objectives, setup instructions, step-by-step participant activities, facilitator tips, debrief questions, and a verified source list.
  • A slide deck (.pptx and .pdf) — 10 to 15 slides styled to the WordPress Design System, with facilitator guidance in speaker notes only.

Activity kits are hosted in the Training Team’s shared Google Drive folder for editing, and added to the Learn WordPress media library in order to link them to their corresponding pages on Learn WordPress.

All kits can be found at https://learn.wordpress.org/activity-library

Activity kits are a distinct content type from lessons, courses, and online workshops. They are designed for self-facilitated, hands-on sessions — not for structured learning paths or instructor-led training.

Creating Activity Kits

Before beginning work on a new activity kit, confirm the following.

First check for duplicates

Search the existing activity kit library at https://learn.wordpress.org/activity-library, and the Training Team’s shared Google Drive to make sure a kit on this topic does not already exist. If a similar kit exists, consider whether an update or expansion is more appropriate than creating a new one.

Post in #training on Making WordPress SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/ before starting. Share your proposed topic and audience level. This allows other contributors to flag duplicates, offer to co-create, or note any related work in progress.

Confirm topic suitability

A topic is suitable for an activity kit if it:

  • Can be completed in a 45-to-90-minute meetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. session.
  • Produces something tangible by the end — a published post, a configured pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party., an audit result, a contribution submitted.
  • Works in WordPress Playground with no install or account required, or has a clearly documented free-tier alternative.
  • Is covered by official WordPress documentation at learn.wordpress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/, wordpress.org/documentation, or developer.wordpress.org, or has reputable and verified sources.

Open a GitHub issue

Once you’ve confirmed your topic has not been created, you’ll want to create a GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged by the repository owner. https://github.com/ issue. Training Team tracks all content work in the LearnWP Content – Development board on GitHub. Opening an issue before you start prevents duplicate work and keeps your progress visible to the team.

  1. Go to github.com/WordPress/Learn/issues/new/choose and select the Activity Kit issue template (or open a blank issue if the template has not been created yet).
  2. Title the issue: “Activity Kit: <your topic>” and add the [type] Activity Kit label. If the label does not exist yet, create it.
  3. The issue will be picked up by the LearnWP Content – Development board automatically. Confirm it appears in the backlog.
  4. Assign the issue to yourself and move it to In Progress on the project board once you begin creating the kit.

Note the issue number — you will update its status at each stage: In Progress when you start, Peer Review when you request feedback, Ready to Publish when approved, and closed when the kit goes live. Also check the LearnWP Topic Vetting board to confirm your topic has not already been vetted or rejected.

Creating the Activity Kit

Activity kits are created using an AI prompt that guides you through the full process — from research and outline to finished files. You do not need to set up any tools yourself; the prompt handles everything. You have two options depending on how you prefer to work.

Option A: Use the prompt package (any AI)

The prompt package works with any generative AI — Claude, Gemini, ChatGPT, or others. It contains the full agent instructions and everything the AI needs to produce a complete, on-brand activity kit.

To get started:

  1. Download the prompts package from the WordPress/Learn repository on GitHub (wp-meetup-activity-prompts.zip).
  2. Open your preferred AI tool (Claude at claude.ai, Gemini at gemini.google.com, ChatGPT at chat.openai.com, or another provider).
  3. Follow the setup instructions in the package’s README for your chosen tool. This typically means pasting the system prompt and uploading two context files.
  4. Once set up, start a conversation with: “Create a new WordPress meetup activity.”
  5. The AI will ask for your topic, audience level, and duration, then walk you through research, outline approval, and file creation.

The README in the prompts package includes specific setup instructions for Claude Projects, ChatGPT Custom GPTs, and Gemini Gems. Choose the path that matches your tool.

Option B: Use the Claude plugin (Claude Cowork)

If you use Claude Cowork, the WordPress Activity Kit Creator plugin is the easiest option. The plugin comes pre-configured with all the necessary context and runs the full workflow for you.

  1. Download the .plugin file from the WordPress/Learn repository on GitHub (wp-meetup-activity-creator.plugin).
  2. Open Claude Cowork and install the plugin by opening the .plugin file.
  3. In a Cowork session, say: “Create a new WordPress meetup activity.”
  4. The plugin will run an onboarding checklist on first use, then guide you through the full creation workflow.

The Claude plugin is the fastest path from idea to finished kit. It handles file generation, PDF export, and visual QA automatically — you just review and approve at each step.

What the AI produces

Whichever option you use, the AI walks you through the same workflow: you provide the topic and audience level, review a research summary, approve a draft outline, and the AI generates the final files. The output is:

  • Facilitator Guide (.docx and .pdf) — learning objectives, setup notes, participant steps, facilitator tips, debrief questions, and a verified source list.
  • Slide Deck (.pptx and .pdf) — 10 to 15 slides styled to the WordPress Design System, with facilitator guidance in speaker notes only.

The AI performs visual QA on every slide before delivering the files. Review the output before moving to peer review.

Peer Review

All activity kits require peer review by at least one other contributor before they are published. Peer review checks instructional quality, editorial standards, and technical accuracy.

Request a reviewer

  1. On GitHub, update your issue label to [status] Peer Review and move the card to the Peer Review column on the LearnWP Content – Development board.
  2. Post in #training and #community-team on Making WordPress Slack with: the topic, audience level, a link to your draft files in Google Drive (view access), and any context reviewers need.
  3. Allow at least five business days for review.

Reviewer checklist

Reviewers should check each of the following:

Instructional design

  • Learning objectives cover 4 or more Bloom’s Taxonomy cognitive levels.
  • Activity steps follow backward design — steps lead directly to the stated objectives.
  • Part 1 is accessible to the least-experienced participant at the stated audience level.
  • Participants produce something tangible during the session.
  • All steps work in WordPress Playground without a paid account.

Editorial

  • “WordPress” is correctly capitalized throughout.
  • Second-person “you,” active voice, US English.
  • No em dashes in body copy.
  • When a specific plugin is the primary tool, 2 to 3 named alternatives are listed with descriptions and links.
  • All plugin steps confirmed on the free tier.

Technical accuracy

  • Every URLURL A specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org in the Sources section returns as valid.
  • All steps verified in WordPress Playground (or the stated alternative environment).
  • No steps require a version of WordPress or a plugin that is no longer current.

Design and accessibility

  • Slide deck uses WordPress Design System colors only.
  • All text on dark slide backgrounds is white (#FFFFFF).
  • Minimum 14pt text on slides.
  • Facilitator tips are in speaker notes only.
  • Resources table first-row labels are not bold.

Reviewers: leave comments directly in the facilitator guide and slides using Google’s comment feature.

Incorporate feedback

Address all reviewer comments before uploading. If you disagree with a suggestion, discuss it in the Slack thread. Once all comments are resolved, notify the reviewer that the kit is ready for upload.

Update the GitHub issue: add the [status] Ready to Publish label and move the card to the Ready to Publish column on the LearnWP Content – Development board.

Uploading to Google Drive

The canonical home for all activity kit files is the Training Team’s shared Google Drive folder. Files here are considered the source of truth.

Folder structure

The shared Drive is organized with one subfolder per activity kit. Use the exact topic name as the folder name.

Upload steps

  1. Open the shared folder: drive.google.com/drive/folders/1kLVaodKXawREaGZQvyQ2z8MfzvdtSdAN
  2. Create a new subfolder named after your topic (exact title case).
  3. Upload all four files: .docx, .pdf (facilitator guide), .pptx, .pdf (slides).
  4. Create a .zip file containing the facilitator guide PDF and the slides PDF. Name it: <Topic> — Activity Kit.zip.
  5. Upload the .zip to the same subfolder.
  6. Verify each file opens correctly in Google Drive preview.
  7. Download all files to your computer so they are ready to upload to the Learn WordPress media library.

Do not change sharing permissions beyond “Anyone with the link can view.” File access is managed at the folder level by Training Team admins.

Publishing on Learn WordPress

Activity kits are published as pages on learn.wordpress.org. Each kit gets its own page that describes the activity, lists what participants will do, and provides download links.

Get editor access

You will need a editor account on learn.wordpress.org to create or edit activity kits. If you do not already have access:

  1. Post in #training on Making WordPress Slack and request contributor access for learn.wordpress.org.
  2. A Training Team admin will grant you the appropriate role.
  3. Log in at learn.wordpress.org/wp-admin using your WordPress.org account.

Upload files to the media library

Both PDF files (facilitator guide and slides) and the .zip file must be uploaded to the Learn WordPress media library.

  1. In the WordPress admin, go to Media > Add New.
  2. Upload the facilitator guide PDF. In the attachment details, set the title to: <Topic> — Facilitator Guide.
  3. Upload the slides PDF. Set the title to: <Topic> — Slides.
  4. Upload the .zip file. Set the title to: <Topic> — Activity Kit.

Use descriptive file names before uploading: “wordpress-security-facilitator-guide.pdf” rather than “guide.pdf”. This makes files easier to find in the media library later.

Create the activity kit page

Activity kit pages follow a standard structure. Use an existing published kit page as a reference before creating a new one.

  1. Go to Activity Kits > Add New Activity Kit in the WordPress admin.
  2. Set the activity title as the activity topic name (title case).
  3. Add a description for what the activity kit covers. The required sections are:
    • Overview blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. — topic, duration, audience level, prerequisites.
    • What you’ll do — 3 to 5 bullet points describing what participants will accomplish.
    • What you’ll need — software, accounts, or browser requirements.
    • Download the kit — links to all four files (PDF and .docx from media library and Google Drive; .pptx from Google Drive).
    • About this activity — one paragraph on learning objectives and instructional approach.
  4. Add the featured imageFeatured image A featured image is the main image used on your blog archive page and is pulled when the post or page is shared on social media. The image can be used to display in widget areas on your site or in a summary list of posts..
  5. Set the appropriate experience level, language, and topic (e.g., Beginner, Intermediate, Site Building, Security).
  6. Attach the three media library files to the kit: facilitator guide PDF, slides PDF, and .zip.
  7. Set the page status to Draft. Do not publish until the final checklist is complete.

The download experience

The kit page presents a single “Download kit” button that delivers the .zip file — no separate links for individual files. The kit page also shows:

  • A Kit Preview section with two tabs (Facilitator Guide / Slide Deck) showing an inline PDF preview of each file.
  • A “What’s included” section listing Facilitator Guide and Slide Deck cards with descriptions.
  • A “Download this kit” block at the bottom with the file size and “Free — No account required” notice.

The single download .zip is what gets attached to the activity kit post. Participants do not need individual file links — everything is in the .zip.

Test the Download kit button in a private/incognito browser window to confirm the .zip downloads without requiring a login.

Pre-Publish Checklist

Complete this checklist before changing the page status from Draft to Published.

Files

  • All five files (.docx, .pdf, .pptx, .pdf, .zip) are in the Google Drive subfolder.
  • Facilitator guide PDF, slides PDF, and .zip are in the Learn WordPress media library with descriptive filenames.
  • Download kit button tested in incognito — .zip downloads without login.
  • Kit preview tabs (Facilitator Guide / Slide Deck) show inline PDF previews correctly.

Activity kit post

  • Activity title matches the topic name (title case).
  • Description includes overview block, “What you’ll do,” and “What you’ll need” sections.
  • Experience level, language, and topic taxonomyTaxonomy A taxonomy is a way to group things together. In WordPress, some common taxonomies are category, link, tag, or post format. https://codex.wordpress.org/Taxonomies#Default_Taxonomies. are set.
  • Featured image is set.
  • All three media library files attached to the post.

Activity kit content

  • Learning objectives cover 4 or more Bloom’s Taxonomy cognitive levels.
  • Peer review complete and all comments resolved.
  • All URLs in Sources section verified live.
  • All steps tested in WordPress Playground.
  • Design system colors only (no #0073AA).
  • All text on dark slide backgrounds is white.
  • Facilitator tips are in speaker notes only (not on slides).

Publish

  1. Change the activity kit status from Draft to Published.
  2. View the published page at /activity-library/<slug>/ and click the Download kit button in incognito to confirm.
  3. Check that the kit appears on the Activity Library with the correct card image, title, description, duration, and level.
  4. Post the published URL in #training on Making WordPress Slack to announce the new kit.
  5. Close the GitHub issue and add the live URL as a comment. The issue will be marked as Published on the LearnWP Content – Development board.

Updating an Existing Kit

Activity kits should be reviewed when a major WordPress release changes relevant features, when a primary URL in the Sources section goes dead, or when community feedback reveals a significant gap.

  • Replace files in Google Drive in-place (do not create a new subfolder). The shareable link does not change.
  • Re-upload updated PDFs and a new .zip to the Learn WordPress media library. Delete the old versions. Reattach the new files to the activity kit post.
  • Update the activity kit post description if the overview or what-you’ll-do sections have changed.
  • Post a note in #training on Making WordPress Slack describing what changed.

Resources

    First published

    Last updated

    WordPress.org
    WordPress.org
    Code is Poetry
    The WordPress® trademark is the intellectual property of the WordPress Foundation.
    s
    search
    c
    compose new post
    r
    reply
    e
    edit
    t
    go to top
    j
    go to the next post or comment
    k
    go to the previous post or comment
    o
    toggle comment visibility
    esc
    cancel edit post or comment