{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/developer-portal/awesome/folders/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Folder structure training

\n

Changing URL paths

\n

The filename is used in the URL path and so is the folder.\nNested folders will result in deep paths.

\n

If you look at the path for this page, you'll see it is at /developer-portal/awesome/folders.

\n

\n \n \n

\n

The title of the page is Folder structure training and doesn't match the path.

\n

\n \n \n

\n

The path is generated from the folder structure path and filename less the filename extension (.md in this case).\nIf the file is named index.md or index.mdx the filename does not appear in the URL path.

\n

If we renamed folders.md to index.md and left it in the same folder, what would the URL be?

\n\n

Let's try it out...

\n

Rename to index

\n

Rename the folders.md file to index.md.

\n

You will also need to change references to that file, which exist in the sidebars.yaml file located in the root directory.

\n\n
\n
\n OriginalNew\n
\n
\n
\n
\n
Copy
\n
Copied
\n
\n 
      - label: Folder structure\n        page: developer-portal/awesome/folders.md
\n
\n
\n
Copy
\n
Copied
\n
\n 
      - label: Folder structure\n        page: developer-portal/awesome/index.md
\n
\n
\n \n

Great? Now, revert the name back to folders.md and revert the change in the sidebars.yaml file.

\n

Move the file to a different folder

\n

Move this folders.md to the root directory.\nThe root directory means it will site side-by-side with other files and folders such as siteConfig.yaml and sidebars.yaml.

\n

This file is referenced in sidebars.yaml.\nAdjust the relative path to the file from there again.

\n\n
\n
\n OriginalNew\n
\n
\n
\n
\n
Copy
\n
Copied
\n
\n 
      - label: Folder structure\n        page: developer-portal/awesome/folders.md
\n
\n
\n
Copy
\n
Copied
\n
\n 
      - label: Folder structure\n        page: folders.md
\n
\n
\n \n

Adjust the relative path to the images within the actual file too.

\n

If the image is broken (does not load), it indicates the path to the image is incorrect.

\n

The current directory means the directory where the markdown file is located.\nThe ./ start means starting from the current directory.\nThe ../ moves up to the parent directory.\nAnd ../../ moves up two levels.\nAnd so on.

\n

Troubleshooting

\n

Files, folders, and navigation paths may be cached.\nIf your page isn't loading check if you have the correct path in the browser.\nIf it still isn't loading, try the yarn clean fix.

","headings":[{"value":"Folder structure training","depth":1},{"value":"Changing URL paths","depth":2},{"value":"Rename to index","depth":3},{"value":"Move the file to a different folder","depth":3},{"value":"Troubleshooting","depth":2}]},"contentItem":{"data":{"lastModified":"2025-12-17T21:55:39.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":true,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"6fdadb5a-f4bd-55ef-912c-4258ce7ef58d__redocly content/developer-portal/awesome/folders/","seo":{"title":"Folder structure training","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null},"pageId":"developer-portal/awesome/folders.md","pageBaseUrl":"/developer-portal/awesome/folders","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Folder structure training","id":"folder-structure-training"},{"depth":2,"value":"Changing URL paths","id":"changing-url-paths"},{"depth":3,"value":"Rename to index","id":"rename-to-index"},{"depth":3,"value":"Move the file to a different folder","id":"move-the-file-to-a-different-folder"},{"depth":2,"value":"Troubleshooting","id":"troubleshooting"}]},"data":{"title":""},"catalogInfo":null,"link":"/developer-portal/awesome/folders/","sidebarName":"","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1180902673","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3743992808","561138138"]}