Replace or remove a feed
Change the feed address for an existing subject and topic, or remove a feed registration from the Feeds Directory.
Use feed replacement when the subject and topic should stay the same but the active feed contract needs to change. Use feed removal when the subject and topic should no longer resolve to any feed.
Replacement and removal update the Feeds Directory registration. They do not edit the old feed contract, rewrite historical values, or decide whether an external market data source is economically correct.
Prerequisites
- Feeds manager role (
feedsManager) assigned on the System Access Manager - An existing feed registration for the subject and topic
- For replacement: the new feed contract address you want consumers to resolve
- Wallet verification configured for the transaction confirmation step
Directory changes affect consumers
Replacing a feed changes which contract is resolved for the subject and topic. Removing a feed makes that subject and topic resolve to no feed. Check downstream price, reporting, and smart contract consumers before confirming either action.
Replace a feed
Open the feed detail actions menu
Go to Platform Settings > Data Feeds. Open the feed detail page, then open the actions menu and choose Replace feed.
Enter the replacement address
Enter the new feed contract address. The replacement keeps the same subject and topic, then points the directory registration at the new address.
The replacement address must be a compatible scalar feed for the same kind of data. It must expose the expected feed interface and use the same decimal precision as the feed being replaced.
Review the before-and-after summary
Review the topic, subject, current feed address, and new feed address. Confirm only when the new feed is the contract that should serve future reads for this subject and topic.
Confirm the transaction
Submit the replacement and complete wallet verification. After the transaction confirms, the Data Feeds list refreshes and future directory resolution uses the replacement feed.
If a Chainlink-compatible adapter is registered for the same subject and topic, it resolves through the directory. After replacement, consumers of that adapter resolve the new feed address instead of the old one.
Remove a feed
Open the remove action
Go to Platform Settings > Data Feeds. Open the feed detail page, then open the actions menu and choose Remove feed.
Review the warning
The confirmation dialog shows the feed address and explains that the registration will be removed. Select the confirmation checkbox only when the subject and topic should no longer resolve to this feed.
Confirm wallet verification
Submit the removal and complete wallet verification. After the transaction confirms, DALP returns you to the Data Feeds list and refreshes feed data.
Removing a registration does not delete the old feed contract. It removes the directory mapping for the subject and topic, so discovery and adapter consumers must handle the missing feed state.
What changes after replacement or removal
| Action | Directory result | Existing feed contract | Consumer impact |
|---|---|---|---|
| Replace feed | The subject and topic resolve to the new feed address | The old contract remains deployed with its historical state | Future reads through the directory or adapter use the replacement feed |
| Remove feed | The subject and topic no longer resolve to a feed | The old contract remains deployed with its historical state | Consumers that rely on directory resolution must handle a missing feed |
Troubleshooting
| Issue | What to check |
|---|---|
| Replace or remove action is not visible | Confirm your user has the Feeds manager role. |
| Replacement address is rejected | Check that the address is a compatible feed contract on the target network and uses the same decimal precision as the current feed. |
| Transaction fails during confirmation | Check wallet verification, gas balance, and whether the subject and topic still resolve to the feed being changed. |
| Consumers still show old data | Wait for the transaction and indexer to complete, then refresh the consumer view. |
Related guides
- Data feeds overview - Roles, scopes, and operating boundaries
- Create a feed - Register issuer-signed or Chainlink-compatible feeds
- Publish a feed update - Submit values to issuer-signed feeds
- Read data feeds - Resolve feeds and read latest or historical values through the API