Wikivoyage:Trip Planner Voyage Tips and guide

The Trip Planner is a client-side (JavaScript) tool that allows you to drag-and-drop Wikivoyage listings into a custom itinerary, view them on a map, and calculate routes. Custom items can be created (with optional coordinates and wikidata reference), and custom notes can be added to all items.

If you don't want to use the tool, please disable it in your preferences.

• Mini Widget Mode: A floating, minimizable widget suitable for reading articles.
• Full View Mode: A full-page split-screen interface with a persistent map on the left and your trip plan, route stats, and bucket/trip administration controls on the right.

• Drag & Drop: Drag any listing from a Wikivoyage article directly into the Trip Planner widget or Full View bins.
  • Listings already in your trip are marked with a green checkmark (✅) on the article page.
  • Note: To drag listings from a source page, the Trip Planner widget must be opened first on that page. If you drop a listing without opening the widget first on the source tab, the planner will show a warning notification.
  • In mobile interface, drag and drop is largely unused. Mobile users can tap the "＋ Trip" button on listings to quickly append them to their trip backlog.
• Organization:
  • Custom Buckets: Organize holding items into custom folders (e.g. food 🍴, sleep 🏨, or custom emojis/characters). Adding, renaming, and removing custom buckets is done via the edit dialog in Full View mode.
  • Days: Assign items to specific days. Drag items to reorder them (the map numbers update automatically).
  • Move Button: Quickly move all items from one day to another, or merge/move them into a different trip or bucket.
• Multi-Tab Synchronization:
  • When you have multiple tabs open (e.g., several article tabs and one Full View tab), data changes sync in real-time across all tabs using browser broadcast channels.
  • Minimizing, expanding, or closing the widget in one tab will not interfere with the window/widget states of other tabs.
• Storage:
  • Logged-in users: Data is saved to your account preferences and syncs across devices.
  • Anonymous users: Data is saved to your browser's local storage.
  • Data merges automatically when you log in.

• In Full View mode, the interactive map is persistently displayed on the left. In Widget mode, click Map to toggle the map canvas.
• Markers are numbered based on their visit order in the list (e.g., "1", "2"). Custom bucket items display their selected custom icons on the map.
• Highlighting: Clicking a marker or route line dims other days/buckets and auto-scrolls the list to the relevant day or bucket header.
• Images: Clicking a marker loads the Wikidata thumbnail image for that location.

To enable routing features, you must provide a OpenRouteService API Key in the Settings menu (Gear icon). You can grab one for free (at this time) on the OpenRouteService page.

• Calculate Route: Draws travel paths on the map and inserts time/distance stats (e.g., "⬇️ 2.5 km / 15 min ⬇️") between items in the list.
• Optimize Day: Reorders a day's items to find the shortest path to visit them all. The first item is kept fixed as the starting point.

The tool supports several formats via the Save... button:

• GPX: For importing into GPS devices or apps like OsmAnd.
• GeoJSON: Includes the route geometry (lines) for use in mapping software.
• WikiText: Generates `  ` templates for pasting back into an article.
• JSON (Backup): Full data export. Use "All Data" to back up multiple trips.

JSON files can be imported as well.