--- title: "Change a setting on one register only" source: https://support.storeconnect.com/articles/pos-per-register-settings type: article format: markdown site: StoreConnect Support — product and developer documentation for StoreConnect site_index: https://storeconnect.com/llms.txt docs_index: https://support.storeconnect.com/llms.txt note: Append .md to any page or article URL on this site to get its Markdown form. --- # Change a setting on one register only Most POS settings apply to every register in the store. A per-register setting lets one register use a different value, such as a service desk that takes card only while the main counter takes cash. A register gets its own value when an operator taps a button that runs the `settings:update` action. There is no settings screen for this, so a store administrator adds the buttons in Salesforce first. ## Settings you can change per register | Setting | Store variable key | Values | Default | |---|---|---|---| | Accept cash at checkout and as a refund destination | `pos.payment_options.cash.enabled` | `true` or `false` | `true` | Every other setting applies to the whole store. Each setting is addressed by the store variable key, the same key described in [POS payment methods](pos-payment-methods). ## How the register's value is chosen The store variable takes priority. When it is set, every register follows it and ignores any value of its own. | Store variable | Register's own value | The register uses | |---|---|---| | Set | Set or not set | The store variable | | Not set | Set | The register's own value | | Not set | Not set | The setting's default | The register keeps its own value on the device until a `settings:reset` button clears it. If the store variable is set later, the store variable takes priority, and the register's own value applies again if the store variable is removed. ## Before you start - Make sure the store variable for the setting is not set on the store. While it is set, the register refuses `settings:update`. See [store variables](store-variables). - Choose the action group where the button should appear. See [POS action groups](pos-action-groups). ## Add a button that changes the setting This example adds a button that turns cash off on the register where an operator taps it. 1. Open the **POS Action Items** list. 2. Click **New**. 3. Set **Name** to a label the operator understands, such as `Turn off cash on this register`. 4. Set **Type** to `action`. 5. Set **Action** to `settings:update`. 6. Set **Params** to `key=pos.payment_options.cash.enabled;value=false`. 7. Set **Parent Action Group** to the group where the button should appear. 8. Save the record. 9. Sync the register. See [manage POS data sync](manage-pos-data-sync). 10. On the register, tap the button. To turn cash back on, add a second button with **Params** set to `key=pos.payment_options.cash.enabled;value=true`. Start a sale on that register and go to checkout. **Cash** is not offered as a payment method, and other registers in the outlet still offer it. ## Return a register to the store setting Add a button that clears the register's own value, so the register follows the store variable, or the default when no store variable is set. 1. Open the **POS Action Items** list. 2. Click **New**. 3. Set **Name** to `Use the store's cash setting`. 4. Set **Type** to `action`. 5. Set **Action** to `settings:reset`. 6. Set **Params** to `key=pos.payment_options.cash.enabled`. 7. Set **Parent Action Group** to the group where the button should appear. 8. Save the record. 9. Sync the register. On a register with no value of its own, tapping the button changes nothing. The button never changes the store variable or any other register. ## Errors at the register | Message | Cause | |---|---| | Unable to update setting. Unknown setting key "…". | The key in **Params** is not in the table of per-register settings, for example because of a typo. `settings:reset` shows the same message, starting "Unable to reset setting". | | Unable to update setting. Invalid value "…" for "…". | The value in **Params** is not `true` or `false`. | | "…" is fixed by a store setting and cannot be changed for this register. | The store variable for the setting is set. Remove it from the store to allow per-register values. | --- ## Follow StoreConnect - [Email Newsletter](https://storeconnect.com/c/lp-newsletter) - [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464) - [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g) - [LinkedIn](https://www.linkedin.com/company/storeconnect) - [X / Twitter](https://x.com/storeconnecthq) ## Popular Links - [Partners](https://storeconnect.com/partners) - [Become a Partner](https://storeconnect.com/become-a-partner) - [News](https://storeconnect.com/articles/news) - [Events](https://storeconnect.com/articles/events) - [Feature Comparison](https://storeconnect.com/how-we-compare) - [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT) - [Book a Demo](https://storeconnect.com/contact) ## Documentation - [Help documentation](https://support.storeconnect.com/help-documentation) - [AI agents](https://support.storeconnect.com/ai) - [Videos & tutorials](https://support.storeconnect.com/videos-tutorials) - [Developer reference](https://support.storeconnect.com/developer-reference) - [Release notes](https://support.storeconnect.com/release-notes) - [Troubleshooting](https://support.storeconnect.com/troubleshooting) - [Trust Center](https://trust.getstoreconnect.com/) - [Status Page](https://status.storeconnect.com/) ## Contact - info@getstoreconnect.com - US +1 415 745 3230 - AUS +61 2 8365 2308 100 S Ashley Dr, Suite 600-2461 Tampa FL 33602-600 USA Level 22, Sydney Place 180 George Street Sydney, NSW, 2000, AUS ## Machine-readable - [Site index for agents](https://storeconnect.com/llms.txt): curated map of the StoreConnect site in llms.txt format - [Documentation index for agents](https://support.storeconnect.com/llms.txt): full technical and product documentation map Every page and article on this site has a Markdown rendering: append `.md` to its URL. Continue in Markdown: [Help documentation](https://support.storeconnect.com/help-documentation.md) · [Developer reference](https://support.storeconnect.com/developer-reference.md) · [Videos & tutorials](https://support.storeconnect.com/videos-tutorials.md) · [Release notes](https://support.storeconnect.com/release-notes.md) --- StoreConnect Support — https://support.storeconnect.com/articles/pos-per-register-settings