Create child theme
ps_create_child_theme
Creates a child theme that holds your changes, so theme updates don't wipe them.
TellMyShop Free: No. This tool is only in TellMyShop Pro. TellMyShop Free has only ready reports that read your store.
Ask Claude
„Before we change the theme, set up a child theme so the next theme update doesn't wipe our edits.”
Example preview
New child theme "classic-child" (display name "Classic child") with parent "classic". File: themes/classic-child/config/theme.yml. The theme will not be activated: switch it on in Design > Theme & Logo.
Technical details
Creates a child theme of the active theme: folder themes/<name>/ with config/theme.yml, inheriting the parent's templates, CSS and JS. Changes made in the child theme survive updates of a bought theme or Classic. The theme is NOT activated: the owner switches it on in the back office (Design > Theme & Logo > Use this theme), and further changes go into the child theme (ps_write_theme_file, ps_override_module_template). A child theme can't be created for a theme that is already a child. Needs the Theme switch.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Theme folder name (lowercase letters, digits, - and _), for example classic-child. |
| display_name | string | no | Name shown in the back office. Max 64 characters. |
| confirm | boolean | no | false (default) returns a preview and saves nothing. true executes, only after the user approved the preview, together with change_token. |
| change_token | string | when: confirm=true | Token from the preview. Required with confirm=true. Valid 30 minutes, single use, bound to the previewed arguments and data state. |
Limits
Folder name 3-41 characters: lowercase letters, digits, - and _. Not activated automatically. Not undone by ps_revert_change: remove the theme in the back office if needed.
What you see before anything is saved
Claude first calls the tool without confirming it. The module returns a preview (current and new values) and a single-use token valid for 30 minutes. Claude shows you the preview and saves the change only after your yes.
Related tools
- List theme files ps_list_theme_files
- Write theme file ps_write_theme_file
- Clear cache ps_clear_cache
Use cases with this tool
Last updated: 2026-10-11