{
    "mode": "man",
    "parameter": "bundle-outdated",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/bundle-outdated/1/json",
    "generated": "2026-09-04T03:33:07Z",
    "synopsis": "bundle  outdated  [GEM]  [--local]  [--pre] [--source] [--strict] [--parseable | --porcelain]\n[--group=GROUP]  [--groups]   [--patch|--minor|--major]   [--filter-major]   [--filter-minor]\n[--filter-patch] [--only-explicit]",
    "sections": {
        "NAME": {
            "content": "bundle-outdated - List installed gems with newer versions available\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "bundle  outdated  [GEM]  [--local]  [--pre] [--source] [--strict] [--parseable | --porcelain]\n[--group=GROUP]  [--groups]   [--patch|--minor|--major]   [--filter-major]   [--filter-minor]\n[--filter-patch] [--only-explicit]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "Outdated  lists  the  names  and  versions of gems that have a newer version available in the\ngiven source. Calling outdated with [GEM [GEM]] will only check for  newer  versions  of  the\ngiven gems. Prerelease gems are ignored by default. If your gems are up to date, Bundler will\nexit with a status of 0. Otherwise, it will exit 1.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "--local",
                    "content": "Do not attempt to fetch gems remotely and use the gem cache instead.\n\n--pre  Check for newer pre-release gems.\n",
                    "long": "--local"
                },
                {
                    "name": "--source",
                    "content": "Check against a specific source.\n",
                    "long": "--source"
                },
                {
                    "name": "--strict",
                    "content": "Only list newer versions allowed by your Gemfile requirements, also respecting conser‐\nvative update flags (--patch, --minor, --major).\n\n--parseable, --porcelain\nUse minimal formatting for more parseable output.\n",
                    "long": "--strict"
                },
                {
                    "name": "--group",
                    "content": "List gems from a specific group.\n",
                    "long": "--group"
                },
                {
                    "name": "--groups",
                    "content": "List gems organized by groups.\n",
                    "long": "--groups"
                },
                {
                    "name": "--minor",
                    "content": "Prefer updating only to next minor version.\n",
                    "long": "--minor"
                },
                {
                    "name": "--major",
                    "content": "Prefer updating to next major version (default).\n",
                    "long": "--major"
                },
                {
                    "name": "--patch",
                    "content": "Prefer updating only to next patch version.\n",
                    "long": "--patch"
                },
                {
                    "name": "--filter-major",
                    "content": "Only list major newer versions.\n",
                    "long": "--filter-major"
                },
                {
                    "name": "--filter-minor",
                    "content": "Only list minor newer versions.\n",
                    "long": "--filter-minor"
                },
                {
                    "name": "--filter-patch",
                    "content": "Only list patch newer versions.\n",
                    "long": "--filter-patch"
                },
                {
                    "name": "--only-explicit",
                    "content": "Only list gems specified in your Gemfile, not their dependencies.\n",
                    "long": "--only-explicit"
                }
            ]
        },
        "PATCH LEVEL OPTIONS": {
            "content": "See bundle update(1) bundle-update.1.html for details.\n",
            "subsections": []
        },
        "FILTERING OUTPUT": {
            "content": "The  3  filtering  options do not affect the resolution of versions, merely what versions are\nshown in the output.\n\nIf the regular output shows the following:\n\n\n\n* Gem       Current  Latest  Requested  Groups\n* faker     1.6.5    1.6.6   ~> 1.4     development, test\n* hashie    1.2.0    3.4.6   = 1.2.0    default\n* headless  2.2.3    2.3.1   = 2.2.3    test\n\n\n\n--filter-major would only show:\n\n\n\n* Gem       Current  Latest  Requested  Groups\n* hashie    1.2.0    3.4.6   = 1.2.0    default\n\n\n\n--filter-minor would only show:\n\n\n\n* Gem       Current  Latest  Requested  Groups\n* headless  2.2.3    2.3.1   = 2.2.3    test\n\n\n\n--filter-patch would only show:\n\n\n\n* Gem       Current  Latest  Requested  Groups\n* faker     1.6.5    1.6.6   ~> 1.4     development, test\n\n\n\nFilter options can be combined. --filter-minor and --filter-patch would show:\n\n\n\n* Gem       Current  Latest  Requested  Groups\n* faker     1.6.5    1.6.6   ~> 1.4     development, test\n\n\n\nCombining all three filter options would be the same result as providing none of them.\n\nAugust 2023                          BUNDLE-OUTDATED(1)",
            "subsections": []
        }
    },
    "summary": "bundle-outdated - List installed gems with newer versions available",
    "flags": [
        {
            "flag": "",
            "long": "--local",
            "arg": null,
            "description": "Do not attempt to fetch gems remotely and use the gem cache instead. --pre Check for newer pre-release gems."
        },
        {
            "flag": "",
            "long": "--source",
            "arg": null,
            "description": "Check against a specific source."
        },
        {
            "flag": "",
            "long": "--strict",
            "arg": null,
            "description": "Only list newer versions allowed by your Gemfile requirements, also respecting conser‐ vative update flags (--patch, --minor, --major). --parseable, --porcelain Use minimal formatting for more parseable output."
        },
        {
            "flag": "",
            "long": "--group",
            "arg": null,
            "description": "List gems from a specific group."
        },
        {
            "flag": "",
            "long": "--groups",
            "arg": null,
            "description": "List gems organized by groups."
        },
        {
            "flag": "",
            "long": "--minor",
            "arg": null,
            "description": "Prefer updating only to next minor version."
        },
        {
            "flag": "",
            "long": "--major",
            "arg": null,
            "description": "Prefer updating to next major version (default)."
        },
        {
            "flag": "",
            "long": "--patch",
            "arg": null,
            "description": "Prefer updating only to next patch version."
        },
        {
            "flag": "",
            "long": "--filter-major",
            "arg": null,
            "description": "Only list major newer versions."
        },
        {
            "flag": "",
            "long": "--filter-minor",
            "arg": null,
            "description": "Only list minor newer versions."
        },
        {
            "flag": "",
            "long": "--filter-patch",
            "arg": null,
            "description": "Only list patch newer versions."
        },
        {
            "flag": "",
            "long": "--only-explicit",
            "arg": null,
            "description": "Only list gems specified in your Gemfile, not their dependencies."
        }
    ],
    "examples": [],
    "see_also": []
}