Manage hook positions
ps_manage_hook_positions
Write · preview + approveBlock 3 · Appearance & deployments (service connector, off by default)Service connector onlyBlock off after install
Changes where on the page modules appear and in what order.
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
Reads and changes which modules are shown in which hook (for example displayHome or displayFooter) and in what order, like Design > Positions in the back office. Service connector only (allowlisted IP addresses).
Parameters
Parameter names are not confirmed in module 0.3.0 yet and may change.
| Name | Type | Required | Description |
|---|---|---|---|
| hook | string | no | Hook name. |
| module | string | no | Technical module name. |
| shop_id | integer | no | Shop ID in a multistore installation. Defaults to the shop in the connector address. IDs are listed by ps_get_shop_info. |
| 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
Check the result with 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
Last updated: 2026-10-03