Install or update module from ZIP
ps_install_module
Installs a new module, or updates one you already have, from a download link you give, after showing its name, version and source.
Free TellMyShop Audit: No. This tool is only in the paid version of TellMyShop. The free TellMyShop Audit has only tools that read your store.
Ask Claude
„Install the gift wrapping module from this link: https://github.com/acme/ps-giftwrap/releases/download/v1.4.0/giftwrap.zip”
Example preview
Package from github.com, 412 KB, SHA-256 9c1e...a07b. Module giftwrap 1.4.0 ("Gift wrapping"), one folder, no unsafe paths. Not installed in this shop yet. Action: install, about 20-60 seconds.Technical details
Installs a new module (action=install) or updates an installed one (action=update) from a ZIP package at an https address (for example a GitHub release or a link from the author). The preview downloads and checks the package: module name and version, source, SHA-256 checksum, structure (one module folder, no unsafe paths). This is code that runs on the shop's server: install only from trusted sources and show the user the source and version. An update backs up the module's files first, but database changes made by the update can't be undone.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| action | enum: install | update | yes | install = new module, update = newer version of an installed module. |
| url | string | yes | https address pointing directly to the .zip file. Max 2000 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
https link straight to a .zip, max 30 MB, up to 5 redirects. One module per call, usually 20-60 s. ps_revert_change doesn't undo installs or updates. Block 4, service connector only.
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 modules ps_list_modules
- Enable or disable module ps_toggle_module
- Module settings ps_module_config
Use cases with this tool
Last updated: 2026-10-05