Teams spend plenty of time designing new features. They often improvise when removing them.
That is how deprecation copy turns chaotic fast.
The billing page uses one date. The settings screen uses another. A banner says “ending soon” while the modal says “migrating now.” Support writes a macro explaining a different next step than the product actually offers. Screenshots in launch materials still show the retiring feature as if nothing changed.
This is not only a writing problem. It is a coordination problem.
CopyDoc is a strong fit because the plugin helps teams export, review, update, and re-import text across Figma designs without relying on scattered manual edits. For deprecation work, that matters because the same message usually appears across many surfaces and states at once.
This article is intentionally different from nearby CopyDoc pieces like Feature Flag Copy Rollout Workflow in Figma, Figma Terminology Audit Workflow, and Pricing and Billing Copy Review Workflow in Figma. Those cover staged releases, terminology drift, or pricing-language consistency. This one is about deprecation and sunset messaging, where the core challenge is guiding users through a disappearing workflow without contradictions between product, support, and design.
Treat deprecation as a timeline, not a single message
This is the mistake I see most often.
Teams write one announcement and assume it can do every job.
In reality, feature retirement usually needs at least three message phases:
1. Early awareness
The user learns:
- what is changing
- roughly when
- why it matters
2. Action period
The user learns:
- what they must do
- what happens if they do nothing
- where to go next
3. Post-removal state
The user learns:
- what replaced the feature
- what is no longer available
- where to get help if they still need the old outcome
If those phases are blurred together, the copy becomes vague because it is trying to sound permanent and transitional at the same time.
Inventory every surface before rewriting anything
Deprecation work becomes painful when the team only updates the obvious screens.
Start by exporting or collecting the text across:
- in-app banners
- settings pages
- upgrade or billing screens
- confirmation modals
- empty states after removal
- screenshot-heavy support or marketing mockups
The goal is to see all the user-facing language in one review object before making decisions.
That is exactly where CopyDoc helps. The team stops hunting screen by screen and can review the message system as a connected set of strings rather than isolated surprises.
Separate factual copy from emotional copy
Deprecation messages have two jobs:
- explain the operational truth
- reduce panic and confusion
Those are not the same sentence.
Factual copy usually includes:
- the date or timing
- the affected feature or plan
- the replacement path
- whether data, access, or behavior changes
Emotional copy usually includes:
- reassurance
- acknowledgment of disruption
- support path
- clarity about what to do next
When teams try to squeeze both into one dense paragraph, users skim past the important part.
The better approach is to keep the factual layer explicit and let the supportive layer do a different job around it.
Name the states so the review file stays sane
Deprecation work often contains multiple versions of almost the same message:
30 days remaining7 days remainingfeature removedlegacy plan still activemigrated successfully
If those states are not named clearly in the review workflow, people approve the wrong version by accident.
Use labels that expose timing and context directly:
banner_pre_sunset_30dmodal_deprecation_confirm_last_weekempty_state_removed_featurebilling_notice_plan_rename_post_launch
That may feel more like systems work than copywriting, but it is what keeps the Figma source, spreadsheet review, and later re-import aligned.
Review the migration path, not only the warning text
A good deprecation message does not only announce loss. It directs behavior.
So the review should ask:
- What should the user do now?
- Where do they go instead?
- Is the replacement workflow named consistently?
- Do screenshots and labels match the new reality?
- Does support describe the same path?
This is where deprecation work often exposes hidden terminology problems. The product may say “move to workspace permissions” while support says “switch to team access controls.” Users do not experience those as minor wording differences. They experience them as uncertainty.
If the team already expects broader naming cleanup, Figma Terminology Audit Workflow is the best companion article.
Re-import only after dates, states, and owners are final
Deprecation copy tends to attract drive-by edits.
Someone updates the timing in Slack. Someone softens the banner language in the doc. Someone changes the button label in the design.
That is exactly how inconsistent rollout copy happens.
CopyDoc works best here when the team uses one explicit rule:
Do not re-import until the timeline, replacement path, and final wording owners are settled.
Otherwise the Figma file becomes a half-updated preview of an unresolved plan.
Always do a post-import visual review for overflow and state drift
Deprecation messages are often longer than the copy they replace.
That creates predictable UI issues:
- warning banners become two lines taller than expected
- side panels lose hierarchy
- buttons wrap into weaker CTA phrasing
- empty states become visually heavy
- screenshots no longer match the current product state
That is why re-import is not the final step.
After the approved copy returns to Figma, review:
- layout pressure
- mobile wrapping
- emphasis hierarchy
- consistency across states
- screenshot and annotation accuracy
If the state labels are not clear in the design after re-import, the rollout team will feel the ambiguity later.
A practical deprecation workflow
For product and content teams, this sequence works well:
- Map the deprecation into awareness, action, and post-removal phases.
- Export copy from every affected product state before rewriting.
- Label each message by timing and state, not just by screen name.
- Review facts, next steps, and terminology as one coordinated system.
- Re-import only after dates, owners, and replacement language are final.
- Run a visual QA pass on the updated Figma states before launch.
CopyDoc helps most when the team is managing repeated text changes across a lot of screens and cannot afford to rely on manual paste-back work. Deprecation projects create exactly that kind of pressure.
The real goal is not elegant warning copy in isolation.
It is making sure the product, the support narrative, and the visible interface all tell the same truth while the feature is changing underneath them.