Shop files (service mode)
ps_server_file
In time-limited service mode, reads and changes any file of the shop, with a backup before every change.
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
„Add a line to robots.txt so search engines don't crawl the /module/ pages.”
Example preview
File root:robots.txt, 2,104 -> 2,125 bytes. Backup before saving. + Disallow: /module/
Technical details
SERVICE MODE. Any shop file: action=list (folder), read (path, from_line), edit (search/replace or content; also a new file, for example your own module or an override), delete (with a backup, restorable). Paths are relative to the shop folder. Protected and never accessible: files with database passwords and keys (app/config/parameters.php, .env...), config/settings.inc.php, var/logs, upload, download and the connector's own folders. PHP files are syntax-checked before saving and every write is backed up. Prefer the block 3 and 4 tools for theme and module files, they have extra checks. Restore: ps_restore_file_backup.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| action | enum: list | read | edit | delete | yes | list | read | edit | delete. |
| path | string | when: action=read, edit or delete | Path relative to the shop folder (list: folder, empty = root). Max 400 characters. |
| from_line | integer | no | read: start line (400 lines per call). |
| search | string | no | edit: exact fragment to replace (must appear exactly once). Max 100,000 characters. |
| replace | string | no | edit: the new fragment. Max 100,000 characters. |
| content | string | no | edit: whole new content (instead of search/replace). Max 500,000 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
Service mode only: block 5 is switched on for 1, 4, 8 or 24 hours and works through the service connector from allowlisted IP addresses. read: 400 lines per call, files up to 1 MB. delete: single files up to 5 MB. edit: text files only. 20 file writes per hour, shared by all file tools (adjustable in the Settings: security, alerts, limits card).
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 file backups ps_list_file_backups
- Restore file backup ps_restore_file_backup
- Module files ps_module_file
- Write theme file ps_write_theme_file
Use cases with this tool
- Fix an error page after an update, with a developer's safety net
- Fix a shop file that blocks Google, with a backup
Last updated: 2026-10-05