If the free-gift variant gets added to the cart but still shows its full price at checkout, the discount function isn't firing. Common causes:
1. The discount function isn't installed
Go to Settings → Free gifts in StoreForms. The toggle should be on. If it's off, turn it on — this installs an automatic discount in your Shopify admin under Discounts.
2. Missing scope
If you installed StoreForms before the discount feature shipped, your token may not include write_discounts. Uninstall and reinstall the app to grant the new scope.
3. The cart attribute was cleared
Some themes wipe cart attributes when the customer changes items. StoreForms auto-restores the gift token after any cart change — if you're seeing this, hard-refresh the page and check again. If it persists, send us a link to your store so we can investigate.