Subscriptions & Billing

UptoDocs integrates directly with GitHub Marketplace to manage subscription plans seamlessly. Our pricing is based on Repository Slots, allowing you to choose exactly how many projects need Pro or Enterprise features.

Managing Your Plan

All billing is handled securely through GitHub. You never need to give UptoDocs your credit card directly.

1. Subscribe: Visit the UptoDocs GitHub Marketplace Listing.
2. Choose a Plan: Select Pro or Enterprise.
3. Select Quantity: Choose the number of repositories (units) you want to enable.
   • Example: If you want Pro features on 3 different repos, purchase 3 units.
4. Manage: You can upgrade (add slots), downgrade (remove slots), or cancel directly from your GitHub Billing settings.

Activating Pro/Enterprise Features

Once you have purchased a plan, you receive subscription slots. You must manually assign these slots to the specific repositories you want to upgrade.

1. Check Your Status

To see your current subscription status and available slots, comment the following in any issue or PR in a repository where UptoDocs is installed:

/uptodocs billing

The bot will reply with your current plan information:

Plan: Pro
Status: active
Repository: owner/repo-name

To check available slots before adding repositories, use:

/uptodocs subscription add-repo owner/repo-name

If you have no available slots, you'll see:

❌ No Available Slots
You have utilized all X of your Y purchased slots.
To add owner/repo-name, please upgrade your plan to add more units.

2. Add a Repository

To enable Pro or Enterprise features for a specific repository, navigate to that repository and comment in any issue or PR:

/uptodocs subscription add-repo owner/repo-name

Examples:

• /uptodocs subscription add-repo harsh-goel/uptodocs
• /uptodocs subscription add-repo myorg/backend-api

Requirements:

• UptoDocs must be installed on the target repository
• You must have available slots in your subscription
• Command must be run from the repository being added

Success Response:

✅ Success!
Repository owner/repo-name has been added to your Pro subscription.

Status:
- Slots Used: 2 / 3
- Remaining: 1

3. Remove a Repository

To free up a slot or downgrade a repository back to the Free tier, navigate to that repository and comment:

/uptodocs subscription remove-repo owner/repo-name

Examples:

• /uptodocs subscription remove-repo harsh-goel/legacy-project
• /uptodocs subscription remove-repo myorg/archived-repo

Important:

• The repository will immediately lose access to Pro/Enterprise features
• Your "Remaining Slots" count will increase by 1
• Command must be run from the repository being removed for safety

Success Response:

✅ Success!
Repository owner/repo-name has been removed from your Pro subscription and downgraded to Free.

A slot has been freed up.

Status:
- Slots Used: 1 / 3
- Remaining: 2

4. Change Repository Assignment

To change which repository uses a subscription slot:

/uptodocs subscription change-repo owner/repo-name

For safety, this will prompt you to use the two-step process:

1. First, remove the old repository using /uptodocs subscription remove-repo
2. Then, add the new repository using /uptodocs subscription add-repo

This prevents accidental changes and ensures you have control over the process.

Plan Comparison

Frequently Asked Questions

What happens if I rename my repository?

UptoDocs tracks your repository by its immutable GitHub ID. If you rename old-name to new-name, your subscription will automatically follow the rename without any action required.

Can I transfer a slot to another organization?

Yes. Simply remove the repository from the old organization using remove-repo, and then add the new repository in the other organization using add-repo, provided your GitHub account has admin access to both.

Why must I run commands from the repository itself?

This is a safety measure to prevent accidental modifications. By requiring commands to be run from the repository context, we ensure you're intentionally managing that specific repository.

What happens if I run out of slots?

If you try to add a repository without available slots, UptoDocs will notify you and provide a link to upgrade your plan through GitHub Marketplace.

Can I have multiple repositories on different plans?

Yes. Each repository can be on Free, Pro, or Enterprise independently. You purchase slots for Pro or Enterprise and assign them to specific repositories. Any repository without an assigned slot uses the Free tier.

How do I downgrade or cancel my subscription?

1. First, remove all repositories from your subscription using /uptodocs subscription remove-repo
2. Then, go to your GitHub Marketplace settings
3. Find UptoDocs and cancel or downgrade your plan

All repositories will automatically revert to the Free tier.

What if UptoDocs isn't installed on my target repository?

The /uptodocs subscription add-repo command will fail with a 404 error. You must first install or configure UptoDocs to have access to that repository through the GitHub App settings.

Getting Help

If you have questions about your subscription or need assistance:

• Use /uptodocs help to see all available commands
• Use /uptodocs billing to check your current plan status
• Visit our support page for assistance
• Email us at support@twjlabs.com

Summary

• Purchase slots through GitHub Marketplace
• Add repositories using /uptodocs subscription add-repo owner/repo from that repository
• Remove repositories using /uptodocs subscription remove-repo owner/repo to free slots
• Check status anytime with /uptodocs billing
• All commands must be run from the repository context for safety