> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Swap dashboard identifiers
> Reuse a document's identifier so an old bookmarked URL opens its replacement instead of the original.
export const categoryIcons = {
'administration': 'lock',
'api': 'terminal',
'connections': 'database',
'dashboards': 'table-columns',
'embed': 'code',
'errors': 'exclamation',
'migration': 'angles-right',
'modeling': 'wrench',
'patterns': 'plus',
'schedules & alerts': 'envelope',
'visualizations': 'chart-column',
'workbooks': 'book'
};
export const GuideSidebar = ({category, relatedLinks, updatedDate}) => {
const [progress, setProgress] = React.useState(0);
React.useEffect(() => {
const sidebar = document.querySelector('.guide-sidebar');
if (!sidebar) return;
let container = sidebar.parentElement;
while (container && !container.querySelector('.guide-header')) {
container = container.parentElement;
}
if (container && !container.classList.contains('guide-page-layout')) {
container.classList.add('guide-page-layout');
}
}, []);
React.useEffect(() => {
const handleScroll = () => {
const scrollTop = window.scrollY;
const docHeight = document.documentElement.scrollHeight - window.innerHeight;
const scrollPercent = docHeight > 0 ? scrollTop / docHeight * 100 : 0;
setProgress(Math.min(100, Math.max(0, scrollPercent)));
};
window.addEventListener('scroll', handleScroll, {
passive: true
});
handleScroll();
return () => window.removeEventListener('scroll', handleScroll);
}, []);
const icon = category ? categoryIcons[category.toLowerCase()] || 'book' : 'book';
return ;
};
export const GuideTitle = ({title}) => {
return
{title}
;
};
A document's URL includes its *identifier*, and that's the part people actually save when they bookmark a dashboard or app. This guide uses *document* to mean either one. If you build a replacement and publish it at a new URL, the old bookmark doesn't follow along. It keeps pointing at the original. Since you can't reach into everyone's browser to update a saved bookmark, the fix is to move the identifier itself from the old document to the new one.
Identifiers must be unique across your organization, so this has to happen in two steps: free it up on the old document, then claim it on the new one.
## Requirements
* A **Manager** or higher content role on both documents, which is required to access [document settings](/share#controlling-document-interactivity)
* The old document you're replacing, and the new one that should take its place
## Steps
Open the document you're replacing and change its identifier to something else. The exact value doesn't matter, as long as it's unique, so appending `-old` or `-archived` works fine.
You can get to the **Identifier** field two ways:
* **File > Document settings**
* The **Share** modal's **Settings** tab
Update the **Identifier** field and save. This frees up the original value so it's available for the new document to use.
Open the document that should replace the old one, and set its **Identifier** field to the value you just freed up: the same one from the original bookmarked URL.
Save your changes.
Identifier changes take effect immediately. The next time someone opens the bookmarked link, it will load the new document instead of the old one.
## Next steps
* Review [Changing document URLs and identifiers](/share#changing-document-urls-and-identifiers) for more on identifiers