3
3 Comments

One config toggle can silently invalidate every listing you have published

I moved my plan quotas out of the app and into a config the server serves at runtime. Sensible change: I can adjust the free daily allowance without shipping a release, without waiting for auto-update to reach everyone, without version skew between Windows and macOS.

Then I went to update a directory listing and noticed what I had actually done. Roughly a dozen published pages, store listings, comparison pages and affiliate blurbs all contain a sentence like "10 free actions a day". Every one of those is now a claim about a value that a single admin console change can falsify, quietly, with no deploy, no alert, and no way for me to know which pages just went stale.

Marketing copy is usually treated as static text. The moment a number in it is served by config rather than compiled into the binary, that copy has an undeclared dependency on a system nobody thinks of as customer-facing.

The fix was a writing rule rather than a code change. The plan is permanent, the quota is a current value. So copy now says "free plan with no time limit, currently 10 actions a day", never "free forever at 10 a day". Anywhere the digit is not commercially necessary it says "a free daily allowance" instead, and the website pulls the number from the same config at render time so the page cannot disagree with the product.

Worth checking if you have runtime flags: which of your published claims are quietly downstream of a value somebody can change on a Tuesday afternoon?

posted toAvatar for product ClipWise
ClipWise
  1. 1

    The strongest insight is that runtime config turns marketing copy into a live product dependency. A small quota change can make dozens of otherwise correct pages instantly misleading, so keeping the product and its published claims tied to the same source is a smart safeguard.

  2. 1

    This is a sharp catch, and it's a broader pattern than plan quotas — the same thing happens with feature flags gating UI copy, or A/B test configs that quietly change what "New!" or "Limited time" means on a page nobody's looked at in months. The "plan is permanent, quota is a current value" distinction is a genuinely useful writing rule, not just a patch. Do you have any automated way to flag when marketing copy references a config value (so it doesn't rely on remembering to phrase things that way going forward), or is it purely a discipline/checklist thing for now?

    1. 1
      Honest answer: discipline plus a list, with only one part automated. The automated part is the website. The hero pulls the number from the same config the app reads, so that page physically cannot disagree with the product. If I could do that everywhere I would, and the problem would mostly disappear. The part that cannot be automated is everything I do not control. Store listings, payment provider pages, directory profiles, affiliate blurbs, other people's comparison articles. No script of mine can reach them. So instead of a linter I keep a plain registry: every published surface that names a digit, with a note on where it lives and who can edit it. When the value changes, that list is the blast radius, and updating it is a chore rather than an archaeology project. Your feature flag and A/B examples are worse than my case, because a quota at least changes deliberately. A flag that silently flips "New!" off on a page nobody has opened in months has no moment anyone would think to check. If I were you I would treat any copy string whose truth depends on a flag as needing an owner and an expiry date, the way you would treat a certificate. I am not aware of a tool that does this well. If someone built one I would pay for it, which is probably a hint.