Creating Tours

Tour Management Overview

Tours are the core offerings you provide to tourists. The platform allows you to create multiple tours, each with its own details, pricing, and availability.

Tours go through a review process before becoming active. Draft tours can be edited freely until you’re ready to publish.

Creating Your First Tour

Access the tour creation interface from your dashboard under “Mis recorridos” (My Tours).

Open the Tour Modal

Click the “Crear nuevo recorrido” button to open the tour creation form.

// From dashboard-tours.js
function openModalForCreate() {
  dom.modalTitle.textContent = "Crear nuevo recorrido";
  resetForm();
  dom.modal.classList.add("show");
  document.body.style.overflow = "hidden";
  captureModalSnapshot();
}

Fill in Basic Information

Required Fields

Tour Title

Minimum Length: 5 charactersThe title is the first thing tourists see. Make it descriptive and engaging.Good Examples:

“Tacos, Salsas y Cultura (CDMX)”
“Amanecer en Teotihuacán”
“Arquitectura y Barrios Tradicionales”

// Validation from dashboard-tours.js
const title = dom.fieldTitle.value.trim();
if (title.length < 5) {
  showFieldError(dom.fieldTitle, "El título debe tener al menos 5 caracteres.");
  isValid = false;
}

Description

Minimum Length: 20 charactersProvide a detailed description of what tourists will experience. Include highlights, what makes your tour unique, and what to expect.

const description = dom.fieldDescription.value.trim();
if (description.length < 20) {
  showFieldError(dom.fieldDescription, "La descripción debe tener al menos 20 caracteres.");
  isValid = false;
}

Tour Details

Field	Validation	Description
Price	≥ 0	Tour price in MXN or your currency
Duration	1-12 hours	How long the tour lasts
Max Group Size	1-50 people	Maximum participants per tour
Meeting Point	≥ 5 characters	Where tourists should meet you

// Payload structure from dashboard-tours.js
function getFormPayload() {
  return {
    title: dom.fieldTitle.value.trim(),
    description: dom.fieldDescription.value.trim(),
    price: Number(dom.fieldPrice.value),
    currency: "MXN",
    category: dom.fieldCategory.value.trim(),
    duration: Number(dom.fieldDuration.value),
    maxGroupSize: Number(dom.fieldMaxGroup.value),
    meetingPoint: dom.fieldMeetingPoint.value.trim(),
    includedItems: dom.fieldIncluded.value
      .split(",")
      .map((item) => item.trim())
      .filter(Boolean),
    status: dom.fieldStatus.value,
  };
}

Set realistic group sizes based on your comfort level and the tour type. Smaller groups often lead to better reviews.

Add Included Items

List everything included in the tour price. This helps set expectations and justifies your pricing.Format: Comma-separated listExamples:

Guía profesional, Degustación de tacos, Transporte local, Fotos digitales

// Processing included items
includedItems: dom.fieldIncluded.value
  .split(",")
  .map((item) => item.trim())
  .filter(Boolean)

Common Included Items

Professional guide service
Food tastings
Entry tickets
Transportation
Digital photos
Bottled water
Safety equipment

Choose Tour Status

Tours have three statuses:

Draft

Not Visible to TouristsUse draft status while completing your tour details. You can continue editing without restrictions.

Not published
No bookings accepted
Fully editable

Pending

Under ReviewSubmitted for platform review. Limited editing during review process.

Awaiting approval
Not yet bookable
Review in progress

Active

Live and BookablePublished and accepting bookings. Appears in tourist search results.

Publicly visible
Accepting bookings
Generating revenue

// Status handling from dashboard-tours.js
function getStatusText(status) {
  const map = {
    active: "Activo",
    draft: "Borrador",
    pending: "Pendiente",
  };
  return map[status] || "Sin estado";
}

Managing Existing Tours

Tour Card Display

Your tours are displayed in a grid on the dashboard. Each card shows:

// Tour card structure from dashboard-tours.js
const tour = {
  id: tour.id,
  title: "Tour Title",
  description: "Tour description",
  price: 500,
  currency: "MXN",
  bookings: 42,
  rating: 4.9,
  status: "active",
  category: "Cultural",
  duration: 3,
  maxGroupSize: 10,
  includedItems: ["Guide", "Tastings", "Transport"],
  meetingPoint: "Plaza Principal"
};

Tour Statistics

Bookings: Total confirmed reservations
Rating: Average review score (1-5)
Price: Displayed with currency
Views: Tourist profile views tracking

Available Actions

Edit: Modify tour details
View Reservations: See booking calendar
Duplicate: Create similar tour
Delete: Remove tour (draft only)

Editing Tours

Click “Editar” on any tour card to modify details.

// Edit functionality from dashboard-tours.js
function openModalForEdit(tourId) {
  const tour = state.tours.find((item) => String(item.id) === String(tourId));
  if (!tour) return;
  dom.modalTitle.textContent = "Editar recorrido";
  fillFormWithTour(tour);
  clearFormErrors();
  dom.modal.classList.add("show");
  document.body.style.overflow = "hidden";
  captureModalSnapshot();
}

Unsaved Changes Warning: The system detects unsaved changes and prompts before closing the modal to prevent data loss.

API Integration

Tours sync with the backend through the API client:

// API endpoints from guide-api-services.js
tours: {
  listByGuide: (guideId, filters) =>
    api.get(withQuery(path("/guides/{guideId}/tours", { guideId }), filters)),
  create: (guideId, payload) => 
    api.post(path("/guides/{guideId}/tours", { guideId }), payload),
  update: (guideId, tourId, payload) =>
    api.put(path("/guides/{guideId}/tours/{tourId}", { guideId, tourId }), payload),
  remove: (guideId, tourId) =>
    api.delete(path("/guides/{guideId}/tours/{tourId}", { guideId, tourId })),
  publish: (guideId, tourId) =>
    api.post(path("/guides/{guideId}/tours/{tourId}/publish", { guideId, tourId })),
}

Creating a Tour via API

// From dashboard-tours.js
async function createTour(payload) {
  if (window.KCGuideApi) {
    try {
      const response = await window.KCGuideApi.tours.create(state.guideId, payload);
      const created = response?.data || payload;
      return normalizeTour({
        ...created,
        bookings: created.bookings ?? 0,
        rating: created.rating ?? null,
        imageClass: created.imageClass || getRandomImageClass(),
      });
    } catch (error) {
      console.warn("Create tour pending backend implementation:", error);
    }
  }
  // Fallback for local development
  return normalizeTour({ ...payload, id: uidFromTours(), bookings: 0, rating: null });
}

Form Validation

The platform validates all tour data before submission:

// Complete validation logic
function validateForm() {
  clearFormErrors();
  let isValid = true;

  // Title validation (min 5 characters)
  const title = dom.fieldTitle.value.trim();
  if (title.length < 5) {
    showFieldError(dom.fieldTitle, "El título debe tener al menos 5 caracteres.");
    isValid = false;
  }

  // Description validation (min 20 characters)
  const description = dom.fieldDescription.value.trim();
  if (description.length < 20) {
    showFieldError(dom.fieldDescription, "La descripción debe tener al menos 20 caracteres.");
    isValid = false;
  }

  // Price validation (must be positive number)
  const price = Number(dom.fieldPrice.value);
  if (Number.isNaN(price) || price < 0) {
    showFieldError(dom.fieldPrice, "Ingresa un precio válido.");
    isValid = false;
  }

  // Duration validation (1-12 hours)
  const duration = Number(dom.fieldDuration.value);
  if (Number.isNaN(duration) || duration < 1 || duration > 12) {
    showFieldError(dom.fieldDuration, "La duración debe estar entre 1 y 12 horas.");
    isValid = false;
  }

  // Group size validation (1-50 people)
  const maxGroup = Number(dom.fieldMaxGroup.value);
  if (Number.isNaN(maxGroup) || maxGroup < 1 || maxGroup > 50) {
    showFieldError(dom.fieldMaxGroup, "El grupo debe estar entre 1 y 50 personas.");
    isValid = false;
  }

  return isValid;
}

Best Practices

Compelling Titles

Use descriptive, action-oriented language
Include location for clarity
Keep under 60 characters
Highlight unique aspects

Detailed Descriptions

Paint a picture of the experience
Mention highlights and unique features
Set clear expectations
Include physical requirements

Competitive Pricing

Research similar tours in your area
Consider your experience level
Include value-adds in pricing
Adjust seasonally if needed

Realistic Logistics

Set achievable durations
Keep group sizes manageable
Choose accessible meeting points
List all inclusions accurately

Next Steps

After creating your tours:

Set up calendar availability - Block unavailable dates
Manage incoming bookings - Accept and organize requests
Build your reputation through excellent service and reviews

Popular tours with high ratings appear higher in search results and receive more booking requests.

Overview

For Tourists

For Guides

Features

Tour Management Overview

Creating Your First Tour

Required Fields

Tour Details

Common Included Items

Draft

Pending

Active

Managing Existing Tours

Tour Card Display

Tour Statistics

Available Actions

Editing Tours

API Integration

Creating a Tour via API

Form Validation

Best Practices

Compelling Titles

Detailed Descriptions

Competitive Pricing

Realistic Logistics

Next Steps

Build docs developers (and LLMs) love

Overview

For Tourists

For Guides

Features

​Tour Management Overview

​Creating Your First Tour

​Required Fields

​Tour Details

​Common Included Items

Draft

Pending

Active

​Managing Existing Tours

​Tour Card Display

Tour Statistics

Available Actions

​Editing Tours

​API Integration

​Creating a Tour via API

​Form Validation

​Best Practices

Compelling Titles

Detailed Descriptions

Competitive Pricing

Realistic Logistics

​Next Steps

Build docs developers (and LLMs) love

Tour Management Overview

Creating Your First Tour

Required Fields

Tour Details

Common Included Items

Managing Existing Tours

Tour Card Display

Editing Tours

API Integration

Creating a Tour via API

Form Validation

Best Practices

Next Steps