Manage hook positions
ps_manage_hook_positions
Changes where on the page modules appear and in what order.
TellMyShop Free: No. This tool is only in TellMyShop Pro. TellMyShop Free has only ready reports that read your store.
Ask Claude
„Move the banner above the featured products on the home page.”
Example preview
Hook displayHome: ps_banner 3 -> 1, ps_featuredproducts 1 -> 2, ps_customtext 2 -> 3.
Technical details
Modules in places on the page (hooks), like Design > Positions in the back office. action=list: hook (for example displayHome) -> modules in order, or module -> hooks where it is displayed; without either: display hooks with the number of modules. action=move moves a module within a hook to position (1 = first). action=unhook detaches a module from a hook (it stops showing there but keeps working). action=hook attaches a module (only if the module supports that hook). Changes have a preview with the order before and after and can be undone with ps_revert_change. Changes need the Theme switch.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| action | enum: list | move | unhook | hook | yes | list | move | unhook | hook. |
| hook | string | when: action=move, unhook or hook | Hook name, for example displayHome, displayFooter, displayProductAdditionalInfo. |
| module | string | when: action=move, unhook or hook | Technical module name (ps_list_modules). |
| position | integer | no | move/hook: target position (1 = first). hook without position = at the end. Range 1 to 200. |
| 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
One module and hook per change. Position 1-200. After a change: ps_clear_cache and ps_inspect_page.
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
- Inspect a store page ps_inspect_page
- Clear cache ps_clear_cache
Use cases with this tool
- Change how an add-on behaves when changing its look is not enough
- Reorder the blocks on your homepage
- Remove an add-on you no longer use, safely
Last updated: 2026-10-11